UriMapper.MapUri Method
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Converts a specified uniform resource identifier (URI) into a new URI based on the rules of a matching object in the UriMappings collection.
Assembly: Microsoft.Phone (in Microsoft.Phone.dll)
Parameters
- uri
- Type: System.Uri
Original URI value to be converted to a new URI.
Return Value
Type: System.UriA URI to use for handling the request instead of the value of the uri parameter. If no object in the UriMappings collection matches uri, the original value for uri is returned.
| Exception | Condition |
|---|---|
| InvalidOperationException | The UriMappings property is null. |
The MapUri method returns the mapped URI value from the first object in the UriMappings collection that matches the uri value. If more than one object in the collection matches the uri value, only the mapped URI from the first instance in the collection is returned.
An object in the UriMappings collection matches the uri value if the MapUri for that instance of the UriMapping class returns a value.