Поделиться через

PackagePart.CreateRelationship Метод

  • Ссылка

Определение

Пространство имен:
System.IO.Packaging
Сборка:
System.IO.Packaging.dll
Сборка:
WindowsBase.dll
Пакет:
System.IO.Packaging v8.0.0
Пакет:
System.IO.Packaging v9.0.0-preview.5.24306.7

Создает связь уровня части между этим PackagePart с указанным целевым PackagePart или внешним ресурсом.

Перегрузки

CreateRelationship(Uri, TargetMode, String)

Создает связь уровня части между этим PackagePart с указанным целевым PackagePart или внешним ресурсом.
CreateRelationship(Uri, TargetMode, String, String)

Создает связь уровня части между этим PackagePart с указанным целевым PackagePart или внешним ресурсом.

Комментарии

Связь на уровне части определяет связь между этой частью и целевой частью или ресурсом. Связь на уровне части может быть одной из двух форм.

  • Между исходным PackagePart и целевым PackagePart внутри Package.

  • Между исходным PackagePart целевым ресурсом за пределами пакета.

В связи с частью исходная часть считается "владельцем" отношения. При удалении исходной части все связи, принадлежащие части, также удаляются. Процесс создания или удаления связи физически не изменяет целевую часть или ресурс каким-либо образом.

Метод CreateRelationship физически не изменяет либо исходную часть, либо целевую часть или ресурс каким-либо образом.

Цель связи не может быть другой.

Дополнительные сведения о связях пакетов см. в разделе 1.3 спецификации open Package Conventions (OPC), доступной для скачивания по https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Дополнительные сведения о документах XPS см. в спецификации Open XML Paper (XPS), доступной для скачивания по https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

CreateRelationship(Uri, TargetMode, String)

Исходный код:
PackagePart.cs
Исходный код:
PackagePart.cs
Исходный код:
PackagePart.cs
Исходный код:
PackagePart.cs

Создает связь уровня части между этим PackagePart с указанным целевым PackagePart или внешним ресурсом.

public:
 System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType);
public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType);
member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string -> System.IO.Packaging.PackageRelationship
Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationship

Параметры

targetUri
Uri

Универсальный код ресурса (URI) целевой части.

targetMode
TargetMode

Одно из значений перечисления. Например, Internal, если целевая часть находится внутри Package; или External, если целевой объект является ресурсом за пределами Package.

relationshipType
String

Роль отношения.

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

PackageRelationship

Связь между этим PackagePart с целевым PackagePart или внешним ресурсом.

Исключения

InvalidOperationException

Часть удалена.

-или-

Package не открыт (Dispose(Boolean) или Close() был вызван).

ArgumentNullException

targetUri или relationshipTypenull.

ArgumentOutOfRangeException

Параметр targetMode не является допустимым значением перечисления TargetMode.

ArgumentException

Часть, определяемая targetUri, является связью (цель связи не может быть другой связью).

-или-

targetMode указывается как Internal, но targetUri является абсолютным внешним URI.

IOException

Пакет доступен только для чтения (новая связь не может быть добавлена).

Комментарии

Связь на уровне части определяет связь между этой частью и целевой частью или ресурсом. Связь на уровне части может быть одной из двух форм.

  • Между исходным PackagePart и целевым PackagePart внутри Package.

  • Между исходным PackagePart целевым ресурсом за пределами пакета.

В связи с частью исходная часть считается "владельцем" отношения. При удалении исходной части все связи, принадлежащие части, также удаляются. Процесс создания или удаления связи физически не изменяет целевую часть или ресурс каким-либо образом.

Метод CreateRelationship физически не изменяет либо исходную часть, либо целевую часть или ресурс каким-либо образом.

Цель связи не может быть другой.

Если указан как , должен быть относительным URI, который формируется в соответствии с спецификацией универсального синтаксиса RFC 3986универсального синтаксиса (URI). Внутренний относительный URI может быть абсолютным путем, который начинается с косой черты ("/") символа, например "/page1.xaml" или "/images/picture4.jpg", или относительный путь, например ".. /imagespicture1.jpg", разрешающий корень пакета ("/") в качестве базового URI.

Если targetMode указано как External, targetUri может быть абсолютным или относительным URI, сформированным в соответствии с спецификацией RFC 3986универсального синтаксиса (URI). "https://www.microsoft.com/page2.xml" является примером абсолютного URI, ссылающегося на внешний целевой ресурс "page2.xml". "images/picture1.jpg" является примером относительного URI, который также ссылается на внешний целевой ресурс "1.jpg", но который разрешается против URI самого пакета.

должен быть универсальным кодом ресурса (URI), который формируется в соответствии с спецификацией универсального синтаксиса RFC 3986универсального синтаксиса (URI). Различные типы пакетов могут определять различные типы связей уровня частей. В следующей таблице показаны URI уровня частей, определенные для документов, соответствующихспецификации open XML Paper (XPS).

Связь Part-Level документа XPS URI типа связи
Определения цифровой подписи http://schemas.microsoft.com/xps/2005/06/signature-definitions
Отмена элемента управления http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
Обязательный ресурс http://schemas.microsoft.com/xps/2005/06/required-resource
Ограниченный шрифт http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPart http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragments http://schemas.microsoft.com/xps/2005/06/storyfragments

Дополнительные сведения о связях пакетов см. в разделе 1.3 спецификации open Package Conventions (OPC), доступной для скачивания по https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Дополнительные сведения о документах XPS см. в спецификации open XML Paper (XPS), доступной для скачивания по .

См. также раздел

Применяется к

CreateRelationship(Uri, TargetMode, String, String)

Исходный код:
PackagePart.cs
Исходный код:
PackagePart.cs
Исходный код:
PackagePart.cs
Исходный код:
PackagePart.cs

Создает связь уровня части между этим PackagePart с указанным целевым PackagePart или внешним ресурсом.

public:
 System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType, System::String ^ id);
public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType, string? id);
public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType, string id);
member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string * string -> System.IO.Packaging.PackageRelationship
Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationship

Параметры

targetUri
Uri

Универсальный код ресурса (URI) целевой части.

targetMode
TargetMode

Одно из значений перечисления. Например, Internal, если целевая часть находится внутри Package; или External, если целевой объект является ресурсом за пределами Package.

relationshipType
String

Роль отношения.

id
String

Уникальный идентификатор связи.

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

PackageRelationship

Связь между этим PackagePart с целевым PackagePart или внешним ресурсом.

Исключения

InvalidOperationException

Часть удалена.

-или-

Package не открыт (Dispose(Boolean) или Close() был вызван).

ArgumentNullException

targetUri или relationshipTypenull.

ArgumentOutOfRangeException

Параметр targetMode не является допустимым значением перечисления TargetMode.

ArgumentException

Часть, определяемая targetUri, является связью (цель связи не может быть другой связью).

-или-

targetMode указывается как Internal, но targetUri является абсолютным внешним URI.

IOException

Пакет доступен только для чтения (новая связь не может быть добавлена).

XmlException

id не является допустимым XML-идентификатором.

-или-

Часть с указанным id уже существует.

Комментарии

Связь на уровне части определяет связь между этой частью и целевой частью или ресурсом. Связь на уровне части может быть одной из двух форм.

  • Между исходным PackagePart и целевым PackagePart внутри Package.

  • Между исходным PackagePart целевым ресурсом за пределами пакета.

В связи с частью исходная часть считается "владельцем" отношения. При удалении исходной части все связи, принадлежащие части, также удаляются. Процесс создания или удаления связи физически не изменяет целевую часть или ресурс каким-либо образом.

id должен быть допустимым XML-идентификатором. Тип id — xsd:ID и должен соответствовать соглашениям об именовании, заданным в спецификации XML-схемы 2. Спецификация типов данных (см. https://www.w3.org/TR/xmlschema-2/#ID).

Метод CreateRelationship физически не изменяет либо исходную часть, либо целевую часть или ресурс каким-либо образом.

Цель связи не может быть другой.

Если указан как , должен быть относительным URI, который формируется в соответствии с спецификацией универсального синтаксиса RFC 3986универсального синтаксиса (URI). Внутренний относительный URI может быть абсолютным путем, который начинается с косой черты ("/") символа, например "/page1.xaml" или "/images/picture4.jpg", или относительный путь, например ".. /imagespicture1.jpg", разрешающий корень пакета ("/") в качестве базового URI.

Если targetMode указано как External, targetUri может быть абсолютным или относительным URI, сформированным в соответствии с спецификацией RFC 3986универсального синтаксиса (URI). "https://www.microsoft.com/page2.xml" является примером абсолютного URI, ссылающегося на внешний целевой ресурс "page2.xml". "images/picture1.jpg" является примером относительного URI, который также ссылается на внешний целевой ресурс "1.jpg", но который разрешается против URI самого пакета.

должен быть универсальным кодом ресурса (URI), который формируется в соответствии с спецификацией универсального синтаксиса RFC 3986универсального синтаксиса (URI). Различные типы пакетов могут определять различные типы связей уровня частей. В следующей таблице показаны URI уровня частей, определенные для документов, соответствующихспецификации open XML Paper (XPS).

Связь Part-Level документа XPS URI типа связи
Определения цифровой подписи http://schemas.microsoft.com/xps/2005/06/signature-definitions
Отмена элемента управления http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
Обязательный ресурс http://schemas.microsoft.com/xps/2005/06/required-resource
Ограниченный шрифт http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPart http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragments http://schemas.microsoft.com/xps/2005/06/storyfragments

Дополнительные сведения о связях пакетов см. в разделе 1.3 спецификации open Package Conventions (OPC), доступной для скачивания по https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Дополнительные сведения о документах XPS см. в спецификации open XML Paper (XPS), доступной для скачивания по .

См. также раздел

Применяется к