PackUriHelper.CreatePartUri(Uri) Méthode

Définition

Espace de noms:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Paquet:

System.IO.Packaging v8.0.0

Source:

PackUriHelper.cs

Crée un URI de PackagePart mis en forme.

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

Paramètres

partUri

Uri

URI du PackagePart dans le package.

Retours

Uri

URI de PackagePart mis en forme.

Exceptions

ArgumentNullException

partUri a la valeur null.

ArgumentException

partUri n’est pas un Uri absolu.

Exemples

L’exemple suivant montre comment utiliser la CreatePartUri méthode pour définir des URI relatifs pour PackagePart les éléments.

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

Remarques

L’URI d’un PackagePart est toujours référencé à partir de la Package racine.

L’URI retourné PackagePart est un chemin d’accès absolu qui commence toujours par « / » et est conforme à la syntaxe définie dans la spécification Open Packaging Conventions Specification.

Le tableau suivant illustre des exemples de cas pour CreatePartUri.

partUri	URI de composant retourné
picture1.jpg	/picture1.jpg
/picture2.jpg	/picture2.jpg
a/mydoc.xaml	/a/mydoc.xaml
/b/bar.xaml	/b/bar.xaml

Voir aussi

• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• Écriture d’un exemple de package
• Spécification des conventions d’emballage open