PackUriHelper.CreatePartUri(Uri) 方法

定義

命名空間:

System.IO.Packaging

組件:

System.IO.Packaging.dll

套件:

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

來源:

PackUriHelper.cs

建立格式化的 PackagePart 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

參數

partUri

Uri

封裝內部 PackagePart 的 URI。

傳回

Uri

格式化的 PackagePart URI。

例外狀況

ArgumentNullException

partUri 為 null。

ArgumentException

partUri 不是絕對 Uri。

範例

下列範例示範如何使用 CreatePartUri 方法來定義元素的 PackagePart 相對URI。

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

備註

的 PackagePart URI 一律會從 Package 根目錄參考。

傳回的 PackagePart URI 是一個絕對路徑，一律以 “/” 開頭，且符合 開放式封裝慣例規格中定義的語法。

下表說明的 CreatePartUri範例案例。

partUri	傳回的元件 URI
picture1.jpg	/picture1.jpg
/picture2.jpg	/picture2.jpg
a/mydoc.xaml	/a/mydoc.xaml
/b/bar.xaml	/b/bar.xaml

另請參閱

• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• 開放式封裝慣例規格