Condividi tramite


INavigationContentLoader Interface

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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)

Syntax

'Declaration
Public Interface INavigationContentLoader
public interface INavigationContentLoader

The INavigationContentLoader type exposes the following members.

Methods

  Name Description
Public method BeginLoad Begins asynchronous loading of the content for the specified target URI.
Public method CancelLoad Attempts to cancel content loading for the specified asynchronous operation.
Public method CanLoad Gets a value that indicates whether the specified URI can be loaded.
Public method EndLoad Completes the asynchronous content loading operation.

Top

Remarks

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.

Version Information

Silverlight

Supported in: 5, 4

Platforms

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