PackUriHelper.CreatePartUri(Uri) 方法

定义

命名空间:

System.IO.Packaging

程序集:

System.IO.Packaging.dll

包:

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

Source:

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

注解

始终从Package根目录引用 的 PackagePart URI。

返回的 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)
• 开放打包约定规范