Export (0) Print
Expand All

INavigationContentLoader Interface

Defines methods for loading content that corresponds to a URI.

Namespace:  System.Windows.Navigation
Assembly:  System.Windows.Controls.Navigation (in System.Windows.Controls.Navigation.dll)

public interface INavigationContentLoader

The INavigationContentLoader type exposes the following members.

  NameDescription
Public methodBeginLoadBegins asynchronous loading of the content for the specified target URI.
Public methodCancelLoadAttempts to cancel content loading for the specified asynchronous operation.
Public methodCanLoadGets a value that indicates whether the specified URI can be loaded.
Public methodEndLoadCompletes the asynchronous content loading operation.
Top

Typically, you will not call the methods of this interface directly unless you implement an alternative to the Silverlight navigation system.

You implement this interface to provide custom content loading for the Silverlight navigation system. For example, you can provide a content loader that enables navigation to pages in assemblies that are retrieved from the server on demand. You can also use this interface to implement URI redirection. The Silverlight navigation system requires the final navigation target to be a UserControl instance, although you will typically load Page instances. The Page class derives from the UserControl class and provides additional navigation support.

To use an INavigationContentLoader implementation, create an instance and use it to set the Frame.ContentLoader property. The PageResourceContentLoader class is currently the only INavigationContentLoader implementation in the Silverlight framework. An instance of this class is the default value of the ContentLoader property.

The Frame and NavigationService classes provide a Refresh method in Silverlight 4. This is useful when using navigation extensions that can deliver different content for the same URI depending on user interactions in a particular page. For example, this enables some navigation scenarios with pages that require user authentication.

For information on implementing INavigationContentLoader, see Additional Navigation Resources.

Silverlight

Supported in: 5, 4

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Community Additions

Show:
© 2014 Microsoft