PackagePart.CreateRelationship Метод

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

PackagePart.cs

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

PackagePart.cs

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

Параметры

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

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

Исключения

Комментарии

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

• Между исходным 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).

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

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

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

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• спецификации открытых соглашений о упаковке

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

PackagePart.cs

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

PackagePart.cs

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

Параметры

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

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

Исключения

Комментарии

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

• Между исходным 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).

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

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

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

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• спецификации открытых соглашений о упаковке