PackagePart.CreateRelationship Метод

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

PackagePart.cs

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

PackagePart.cs

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

PackagePart.cs

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

PackagePart.cs

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

PackagePart.cs

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

PackagePart.cs

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

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 физически не изменяет либо исходную часть, либо целевую часть или ресурс каким-либо образом.

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

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

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

relationshipTypeдолжен быть универсальным кодом ресурса (URI) в соответствии с спецификацией универсального синтаксисаRFC 3986. Различные типы пакетов могут определять различные типы связей уровня частей. В следующей таблице показаны URI уровня relationshipType части, определенные для документов, соответствующих спецификации 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
ПечатьБилета	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 Packaging 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
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Спецификация соглашений о открытой упаковке

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

PackagePart.cs

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

PackagePart.cs

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

PackagePart.cs

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

PackagePart.cs

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

PackagePart.cs

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

PackagePart.cs

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

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 физически не изменяет либо исходную часть, либо целевую часть или ресурс каким-либо образом.

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

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

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

relationshipTypeдолжен быть универсальным кодом ресурса (URI) в соответствии с спецификацией универсального синтаксисаRFC 3986. Различные типы пакетов могут определять различные типы связей уровня частей. В следующей таблице показаны URI уровня relationshipType части, определенные для документов, соответствующих спецификации 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
ПечатьБилета	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 Packaging 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
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Спецификация соглашений о открытой упаковке