PackUriHelper.CreatePartUri(Uri) Метод

Определение

Пространство имен:

System.IO.Packaging

Сборка:

System.IO.Packaging.dll

Пакет:

System.IO.Packaging v8.0.0

Исходный код:

PackUriHelper.cs

Создает форматированный URI объекта PackagePart.

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

URI объекта PackagePart пакета.

Возвращаемое значение

Uri

Форматированный URI объекта PackagePart.

Исключения

ArgumentNullException

partUri имеет значение null.

ArgumentException

partUri не является абсолютным Uri.

Примеры

В следующем примере показано, как использовать CreatePartUri метод для определения относительные URI для PackagePart элементов.

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

Комментарии

URI PackagePart объекта всегда ссылается из корневого 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)
• Создание примера пакета
• Спецификация открытых соглашений об упаковке