PackUriHelper.CreatePartUri(Uri) Metoda

Definicja

Przestrzeń nazw:

System.IO.Packaging

Zestaw:

System.IO.Packaging.dll

Tworzy sformatowany PackagePart identyfikator URI.

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

Parametry

partUri

Uri

Identyfikator URI PackagePart elementu w pakiecie.

Zwraca

Uri

Sformatowany PackagePart identyfikator URI.

Wyjątki

ArgumentNullException

partUri to null.

ArgumentException

partUri nie jest bezwzględnym Urielementem .

Przykłady

W poniższym przykładzie pokazano, jak używać CreatePartUri metody do definiowania względnych identyfikatorów URI dla PackagePart elementów.

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

Uwagi

Identyfikator URI obiektu PackagePart jest zawsze przywołyny z Package katalogu głównego.

Zwrócony PackagePart identyfikator URI jest ścieżką bezwzględną, która zawsze zaczyna się od "/" i jest zgodna ze składnią zdefiniowaną w specyfikacji Open Packaging Conventions Specification.

W poniższej tabeli przedstawiono przykładowe przypadki dla programu CreatePartUri.

partUri	Zwrócony identyfikator URI części
picture1.jpg	/picture1.jpg
/picture2.jpg	/picture2.jpg
a/mydoc.xaml	/a/mydoc.xaml
/b/bar.xaml	/b/bar.xaml

Zobacz też

• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• Specyfikacja konwencji otwierania pakietów