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 | |
|---|---|---|
.gif "Public method") |
BeginLoad | Begins asynchronous loading of the content for the specified target URI. |
|
CancelLoad | Attempts to cancel content loading for the specified asynchronous operation. |
|
CanLoad | Gets a value that indicates whether the specified URI can be loaded. |
|
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.
See Also