PackUriHelper.GetPartUri(Uri) Method

Reference

Definition

Namespace:: System.IO.Packaging

Assembly:: System.IO.Packaging.dll

Assembly:: WindowsBase.dll

Package:: System.IO.Packaging v6.0.0

Package:: System.IO.Packaging v7.0.0

Package:: System.IO.Packaging v8.0.0

Package:: System.IO.Packaging v9.0.0-preview.2.24128.5

Source:: PackUriHelper.PackUriScheme.cs

Source:: PackUriHelper.PackUriScheme.cs

Source:: PackUriHelper.PackUriScheme.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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

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

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

Applies to