PackUriHelper.CreatePartUri Method

Creates a formatted PackagePart URI.

Namespace:  System.IO.Packaging
Assembly:  WindowsBase (in WindowsBase.dll)

public static Uri CreatePartUri(
	Uri partUri
)

Parameters

partUri
Type: System.Uri

The URI of the PackagePart within the package.

Return Value

Type: System.Uri
A formatted PackagePart URI.

The URI of a PackagePart is always referenced from the Package root.

The returned PackagePart URI 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 CreatePartUri.

 partUri

 Returned Part URI 

 picture1.jpg 

 /picture1.jpg 

 /picture2.jpg 

 /picture2.jpg 

 a/mydoc.xaml 

 /a/mydoc.xaml 

 /b/bar.xaml 

 /b/bar.xaml 

The following example shows how to use the CreatePartUri method to define relative URIs for PackagePart elements.

// Convert system path and file names to Part URIs. In this example 
// Uri partUriDocument /* /Content/Document.xml */ =
//     PackUriHelper.CreatePartUri( 
//         new Uri("Content\Document.xml", UriKind.Relative));
// Uri partUriResource /* /Resources/Image1.jpg */ =
//     PackUriHelper.CreatePartUri( 
//         new Uri("Resources\Image1.jpg", UriKind.Relative));
Uri partUriDocument = PackUriHelper.CreatePartUri(
                          new Uri(documentPath, UriKind.Relative));
Uri partUriResource = PackUriHelper.CreatePartUri(
                          new Uri(resourcePath, UriKind.Relative));

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft