PackUriHelper.CreatePartUri(Uri) Método

Definição

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Pacote:

System.IO.Packaging v9.0.0-rc.2.24473.5

Origem:

PackUriHelper.cs

Cria uma URI PackagePart formatada.

public:
 static Uri ^ CreatePartUri(Uri ^ partUri);

public static Uri CreatePartUri (Uri partUri);

static member CreatePartUri : Uri -> Uri

Public Shared Function CreatePartUri (partUri As Uri) As Uri

Parâmetros

partUri

Uri

O URI do PackagePart dentro do pacote.

Retornos

Uri

Uma URI PackagePart formatada.

Exceções

ArgumentNullException

partUri é null.

ArgumentException

partUri não é um Uri absoluto.

Exemplos

O exemplo a seguir mostra como usar o CreatePartUri método para definir URIs relativos para PackagePart elementos.

// 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));

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

Comentários

O URI de um PackagePart é sempre referenciado da Package raiz.

O URI retornado PackagePart é um caminho absoluto que sempre começa com "/" e está em conformidade com a sintaxe definida na Especificação de Convenções de Empacotamento Aberto.

A tabela a seguir ilustra casos de exemplo para CreatePartUri.

partUri	URI da parte retornada
picture1.jpg	/picture1.jpg
/picture2.jpg	/picture2.jpg
a/mydoc.xaml	/a/mydoc.xaml
/b/bar.xaml	/b/bar.xaml

Confira também

• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• Especificação de Convenções de Empacotamento Aberto