PackUriHelper.GetPartUri(Uri) Method

Definition

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Source:

PackUriHelper.PackUriScheme.cs

Returns the URI of a PackagePart within a specified pack URI.

public:
 static Uri ^ GetPartUri(Uri ^ packUri);

public static Uri? GetPartUri (Uri packUri);

static member GetPartUri : Uri -> Uri

Public Shared Function GetPartUri (packUri As Uri) As Uri

Parameters

packUri

Uri

The pack URI from which to return the PackagePart URI.

Returns

Uri

The URI of the PackagePart in the given packUri, or null if packUri points to a package instead of a PackagePart.

Exceptions

ArgumentNullException

If the packUri is null.

ArgumentException

If the packUri is not an absolute Uri.

-or-

packUri does not have the "pack://" scheme.

-or-

The partUri extracted from packUri does not conform to the valid partUri syntax.

Remarks

The returned PackagePart URI is relative to the package root and is an absolute path that always starts with "/" and conforms to the syntax defined in the Open Packaging Conventions Specification.

The following table illustrates sample cases for GetPartUri.

packUri	Returned Part URI
pack://http:,,www.proseware.com,mypackage.xyz/a/mydoc.xaml	/a/mydoc.xaml
pack://http:,,www.proseware.com,packages.aspx%3fmypackage/a/bar.xaml	/a/bar.xaml
pack://http:,,www.proseware.com,mypackage.pkg	null
pack://ftp:,,ftp.proseware.com,packages,mypackage1.abc/a/picture.jpg	/a/picture.jpg
pack://file:,,,d:,packages,mypackage2.pkg/a/bar.xaml	/a/bar.xaml

See also

• CreatePartUri(Uri)
• GetNormalizedPartUri(Uri)
• GetPackageUri(Uri)
• Open Packaging Conventions Specification