UriMapping.MapUri Method (System.Windows.Navigation)

Collapse All

Other versions are also available for the following:

Microsoft Silverlight

.NET Framework Class Library for Silverlight

UriMapping..::.MapUri Method

Converts the specified uniform resource identifier (URI) to a new URI, if the specified URI matches the defined template for converting.

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

Syntax

Visual Basic (Declaration)

Public Function MapUri ( _
    uri As Uri _
) As Uri

public Uri MapUri(
    Uri uri
)

Parameters

uri: Type: System..::.Uri
The URI to convert.

Return Value

Type: System..::.Uri
The URI that has been converted or nullNothingnullptra null reference (Nothing in Visual Basic) if the URI cannot be converted.

Exceptions

Exception	Condition
InvalidOperationException	Uri is nullNothingnullptra null reference (Nothing in Visual Basic). -or- MappedUri is nullNothingnullptra null reference (Nothing in Visual Basic). -or- Uri includes a query string. -or- Uri includes a content fragment.

Exception

Condition

InvalidOperationException

Uri is nullNothingnullptra null reference (Nothing in Visual Basic).

-or-

MappedUri is nullNothingnullptra null reference (Nothing in Visual Basic).

-or-

Uri includes a query string.

-or-

Uri includes a content fragment.

Remarks

The MapUri method determines whether the value of uri parameter matches the pattern specified in the Uri property. If the two values match, the MapUri method returns the value of the MappedUri property.

Version Information

Silverlight

Supported in: 5, 4, 3

Platforms

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

Reference

UriMapping Class

System.Windows.Navigation Namespace

Other Resources

Navigation Overview