Sign in

MSDN subscriptions

Get tools

From: Developer's Guide to Microsoft Prism Library 5.0 for WPF

Learn what’s included in Prism 5.0 including the documentation, WPF code samples, and libraries. Additionally find out where to get the library and sample source code and the library NuGet packages.

For a list of the new features, assets, and API changes, see What's New in Prism 5.0.

Documentation

Prism includes the following documentation:

• Developer's Guide to Microsoft Prism 5.0 on MSDN.
• Prism Reference Documentation on MSDN.
• Developer's Guide to Microsoft Prism 5.0 in .pdf format.
• Prism Reference Documentation in chm format.

NuGet Packages

• Prism: Downloads NuGet dependency packages—Prism.Composition, Prism.Interactivity, Prism.Mvvm, and Prism.PubSubEvents NuGet Packages.
• Prism.Composition: Modularity, UI Composition, Bootstrapping, Interactivity, IActiveAware, Navigation, and deprecated NotificationObject and PropertySupport.
• Prism.Interactivity: Interactivity.
• Prism.Mvvm: The Portable Class Library for MVVM and the associated platform specific code to support MVVM. Includes Commanding, BindableBase, ErrorsContainer, IView, and ViewModelLocationProvider.
• Prism.PubSubEvents: The Portable Class Library for PubSubEvents.
• Prism.UnityExtensions: Use these extensions to Prism to build Prism applications based on Unity.
• Prism.MefExtensions: Use these extensions to Prism to build Prism applications based on Managed Extensibility Framework (MEF).

The following table shows common Prism namespaces and in which assemblies and NuGet packages they can be found.

Namespace	Assembly	NuGet Package
Microsoft.Practices.Prism.Logging Microsoft.Practices.Prism.Modularity Microsoft.Practices.Prism.Regions	Microsoft.Practices.Prism.Composition	Prism.Composition
Microsoft.Practices.Prism.Interactivity	Microsoft.Practices.Prism.Interactivity	Prism.Interactivity
Microsoft.Practices.Prism.Commands Microsoft.Practices.Prism.Mvvm Microsoft.Practices.Prism.ViewModel	Microsoft.Practices.Prism.Mvvm	Prism.Mvvm
Microsoft.Practices.Prism.PubSubEvents	Microsoft.Practices.Prism.PubSubEvents	Prism.PubSubEvents

Download and Setup the Prism Source Code

This section describes how to install Prism. It involves the following three steps:

1. Install system requirements.
2. Download and extract the Prism source code and documentation.
3. Compile and run the QuickStarts, Reference Implementation, or Prism Library source code.

Step 1: Install System Requirements

Prism was designed to run on the Microsoft Windows 8 desktop, Microsoft Windows 7, Windows Vista, or Windows Server 2008 operating system. WPF applications built using this guidance require the .NET Framework 4.5.

Before you can use the Prism Library, the following must be installed:

• Microsoft .NET Framework 4.5 (installed with Visual Studio 2012) or Microsoft .NET Framework 4.51.
• Microsoft Visual Studio 2012 or 2013 Professional, Premium, or Ultimate editions.

Optionally, you should consider also installing the following:

• Microsoft Blend for Visual Studio 2013. A professional design tool for creating compelling user experiences and applications for WPF.

Step 2: Download and Extract the Prism Source Code and Documentation

You can download the source code for the Prism library, the reference implementation and the QuickStarts from the following link:

• Prism 5.0

To install the Prism assets, right-click the exe file or zip file, and then click Run as administrator. This will extract the source code into the folder of your choice.

Sample	Category	Description
Stock Trader Reference Implementation	Prism	The Stock Trader RI application is a reference implementation that illustrates the baseline architecture. Within the application, you will see solutions for common, and recurrent, challenges that developers face when creating composite WPF applications. The Stock Trader RI illustrates a fictitious, but realistic financial investments scenario. Contoso Financial Investments (CFI) is a fictional financial organization that is modeled after real financial organizations. CFI is building a new composite application to be used by their stock traders.
Hello World Hands-on Lab	Get Started	The Hello World Hands-on Lab demonstrates the end solution for the hands-on lab "Getting Started Using the Prism Library 5.0 for WPF Hands-on Lab." In this lab, you will learn the basic concepts of Prism and apply them to create a Prism Library solution that you can use as the starting point for building a composite WPF.
Modularity QuickStarts for Unity Modularity QuickStarts for MEF	Modularity	The Modularity QuickStarts demonstrate how to code, discover, and initialize modules using Prism. These QuickStarts represent an application composed of several modules that are discovered and loaded in the different ways supported by the Prism Library using MEF and Unity as the composition containers.
MVVM QuickStart	MVVM	The MVVM QuickStart demonstrates how to build an application that implements the MVVM presentation pattern, showing some of the more common challenges that developers can face, such as wiring a view and view model using the ViewModelLocator, validation, UI interactions, and data templates.
Commanding QuickStart	Commanding	The Commanding QuickStart demonstrates how to build a WPF UI that uses commands provided by the Prism Library to handle UI actions in a decoupled way.
UI Composition QuickStart	UI Composition	This QuickStart demonstrates how to build WPF UIs composed of different views that are dynamically loaded into regions and that interact with each other in a decoupled way. It illustrates how to use both the view discovery and view injection approaches for UI composition.
State-Based Navigation QuickStart	Navigation	This QuickStart demonstrates an approach to define the navigation of a simple application. The approach used in this QuickStart uses the WPF Visual State Manager (VSM) to define the different states that the application has and defines animations for both the states and the transitions between states.
View-Switching Navigation QuickStart	Navigation	This QuickStart demonstrates how to use the Prism Region Navigation API. The QuickStart shows multiple navigation scenarios, including navigating to a view in a region, navigating to a view in a region contained in another view (nested navigation), navigation journal support, just-in-time view creation, passing contextual information when navigating to a view, views and view models participating in navigation, and using navigation as part of an application built through modularity and UI composition.
Event Aggregation QuickStart	Event Aggregation	This QuickStart demonstrates how to build a WPF application that uses the Event Aggregator service. This service enables you to establish loosely coupled communications between components in your application.
Interactivity QuickStart	Interactivity	This QuickStart demonstrates how to create a view and view model that work together when the view model needs to interact with the user or user gesture needs to raise an event that invokes a command. In each of these scenarios the view model should not need to know about the view. The first scenario is handled by using InteractionRequests and InteractionRequestTriggers. The second scenario is handled by InvokeCommandAction.

Step 3: Compile and Run QuickStarts, Reference Implementation, or Prism Library Source Code

In order to build and run the reference implementation and the QuickStarts, select the appropriate shortcut file and press F5 to build and run.

The reference implementation and QuickStarts use NuGet references to the Prism library assemblies so you can compile and run each solution directly.

Adding Prism Library Source Projects to Solutions

As part of shipping the Prism Library as NuGet packages, the Prism Library projects were removed from the solutions of all QuickStarts and reference implementation projects. If you are a developer accustomed to stepping through the Prism Library code as you build your application, there are a couple of options:

• Add the Prism Library Projects back in. To do this, right-click the solution, point to Add, and then click Existing project. Select the Prism Library projects. Then, to prevent inadvertently building these, click Configuration Manager on the Build menu, and then clear the Build check box for all Prism Library projects in both the debug and release configurations.
• Set a breakpoint and step in. Set a break point in your application's bootstrapper, and then step in to a method within the base class (F11 is the typical C# keyboard shortcut for this). You may be asked to locate the Prism Library source code, but often, the full program database (PDB) file is available and the file will simply open. You may set breakpoints in any Prism Library project by opening the file and setting the breakpoint.

Related Downloads

• ManifestManagerUtility for ClickOnce
• Getting Started Using the Prism Library Hands-on Lab
• MVVM Training

Next Topic | Previous Topic | Home | Community

Have a suggestion to improve MSDN Library?

Visit our UserVoice Page to submit and vote on ideas!

Make a suggestion