PackUriHelper.GetRelativeUri(Uri, Uri) Method

Definition

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Returns the relative URI between two specified PackagePart URIs.

public:
 static Uri ^ GetRelativeUri(Uri ^ sourcePartUri, Uri ^ targetPartUri);

public static Uri GetRelativeUri (Uri sourcePartUri, Uri targetPartUri);

static member GetRelativeUri : Uri * Uri -> Uri

Public Shared Function GetRelativeUri (sourcePartUri As Uri, targetPartUri As Uri) As Uri

Parameters

sourcePartUri

Uri

The URI of the source part.

targetPartUri

Uri

The URI of the target part.

Returns

Uri

The relative URI from sourcePartUri to targetPartUri.

Exceptions

ArgumentNullException

sourcePartUri or targetPartUri is null.

ArgumentException

Either the sourcePartUri or targetPartUri does not have a valid Uri syntax.

Remarks

The following table illustrates sample cases for GetRelativeUri.

sourcePartUri	targetPartUri	Returned relative URI
/mydoc/markup/page.xml	/mydoc/markup/picture.jpg	picture.jpg
/mydoc/markup/page.xml	/mydoc/picture.jpg	../picture.jpg
/mydoc/markup/page.xml	/mydoc/images/picture.jpg	../images/picture.jpg

See also

• ResolvePartUri(Uri, Uri)
• Open Packaging Conventions Specification