PackagePart.CreateRelationship Метод

Определение

Создает связь на уровне части между данным объектом PackagePart и указанным целевым объектом PackagePart или внешним ресурсом.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

Перегрузки

CreateRelationship(Uri, TargetMode, String)

Создает связь на уровне части между данным объектом PackagePart и указанным целевым объектом PackagePart или внешним ресурсом.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

CreateRelationship(Uri, TargetMode, String, String)

Создает связь на уровне части между данным объектом PackagePart и указанным целевым объектом PackagePart или внешним ресурсом.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

Комментарии

Связь уровня части определяет связь между этой частью и целевой частью или ресурсом.A part-level relationship defines an association between this part and a target part or resource. Отношение уровня части может быть одной из двух форм.A part-level relationship can be one of two forms.

В связи с частью исходная часть считается "владельцем" связи.In a part-relationship the source part is considered the "owner" of the relationship. При удалении исходной части также удаляются все связи, принадлежащие этой части.When the source part is deleted, all the relationships owned by the part are also deleted. Процесс создания или удаления связи физически не изменяет целевую часть или ресурс каким бы то ни было.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

CreateRelationshipМетод не изменяет физическое изменение исходной части или целевой части или ресурса каким либо образом.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

Целевой объект связи не может быть другой связью.The target of a relationship cannot be another relationship.

Дополнительные сведения о связях между пакетами см. в разделе 1,3 спецификации Open Packaging Conventions (OPC) , доступной для загрузки по адресу https://go.microsoft.com/fwlink/?LinkID=71255 .For more information about package relationships see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

Дополнительные сведения о XPS-документах см. в документации по формату Open XML (XPS) , доступной для загрузки по адресу https://go.microsoft.com/fwlink/?LinkID=67000 .For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at https://go.microsoft.com/fwlink/?LinkID=67000.

CreateRelationship(Uri, TargetMode, String)

Создает связь на уровне части между данным объектом PackagePart и указанным целевым объектом PackagePart или внешним ресурсом.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

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 целевой части.The URI of the target part.

targetMode
TargetMode

Одно из значений перечисления.One of the enumeration values. Например, Internal определяет целевую часть, находящуюся внутри Package, а External — целевой ресурс вне Package.For example, Internal if the target part is inside the Package; or External if the target is a resource outside the Package.

relationshipType
String

Роль связи.The role of the relationship.

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

PackageRelationship

Связь на уровне части между данным объектом PackagePart и целевым объектом PackagePart или внешним ресурсом.The part-level relationship between this PackagePart to the target PackagePart or external resource.

Исключения

Данная часть была удалена.The part has been deleted.

-или--or- Объект Package не открыт (вызван метод Dispose(Boolean) или Close()).The Package is not open (Dispose(Boolean) or Close() has been called).

Параметр targetUri или relationshipType имеет значение null.targetUri or relationshipType is null.

Параметр targetMode не является допустимым значением перечисления TargetMode.The targetMode parameter is not a valid TargetMode enumeration value.

Часть, заданная параметром targetUri, является связью (целевым объектом связи не может быть другая связь).The part identified by the targetUri is a relationship (the target of a relationship cannot be another relationship).

-или--or- В качестве targetMode задано Internal, однако targetUri является абсолютным внешним URI.targetMode is specified as Internal but targetUri is an absolute external URI.

Пакет доступен только для чтения (добавление новой связи невозможно).The package is read-only (a new relationship cannot be added).

Комментарии

Связь уровня части определяет связь между этой частью и целевой частью или ресурсом.A part-level relationship defines an association between this part and a target part or resource. Отношение уровня части может быть одной из двух форм.A part-level relationship can be one of two forms.

В связи с частью исходная часть считается "владельцем" связи.In a part-relationship the source part is considered the "owner" of the relationship. При удалении исходной части также удаляются все связи, принадлежащие этой части.When the source part is deleted, all the relationships owned by the part are also deleted. Процесс создания или удаления связи физически не изменяет целевую часть или ресурс каким бы то ни было.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

CreateRelationshipМетод не изменяет физическое изменение исходной части или целевой части или ресурса каким либо образом.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

Целевой объект связи не может быть другой связью.The target of a relationship cannot be another relationship.

Если targetMode параметр имеет значение Internal , то параметр targetUri должен представлять собой относительный URI, сформированный в соответствии с универсальной спецификацией синтаксиса в стандарте URI RFC 3986 .If targetMode is specified as Internal, targetUri must be a relative URI that is formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. Внутренний относительный URI может быть либо абсолютным путем, который начинается с косой черты ("/"), например "/Page1.XAML", либо "/Images/picture4.jpg", либо относительным путем, таким как ".. /imagespicture1.jpg ", который разрешается в корневую папку пакета ("/") как базовый URI.The internal relative URI can be either an absolute path that starts with a forward slash ("/") character such as "/page1.xaml" or "/images/picture4.jpg", or a relative path such as "../imagespicture1.jpg" that resolves against the package root ("/") as the base URI.

Если targetMode параметр имеет значение External , то параметр targetUri может быть абсолютным или ОТносительным URI, сформированным в соответствии со спецификацией универсального синтаксиса URI RFC 3986 .If targetMode is specified as External, targetUri can be either an absolute or relative URI formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. "https://www.microsoft.com/page2.xml" пример абсолютного URI, который ссылается на внешний целевой ресурс "page2.xml"."https://www.microsoft.com/page2.xml" is an example of an absolute URI that references an external target resource "page2.xml". "Images/picture1.jpg" — это пример относительного URI, который также ссылается на внешний целевой ресурс "1.jpg", но он разрешается в URI самого пакета."images/picture1.jpg" is an example of a relative URI that also references an external target resource "1.jpg" but which resolves against the URI of the package itself.

relationshipTypeдолжен быть URI, сформированным согласно спецификации универсального синтаксиса URI RFC 3986 .relationshipType must be a URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. Различные типы пакетов могут определять разные типы отношений уровня части.Different package types can define different part-level relationship types. В следующей таблице показаны URI уровня части relationshipType , определенные для документов, которые соответствуют стандарту формата XPS.The following table shows the part-level relationshipType URIs defined for documents that conform to the Open XML Paper Specification (XPS).

Отношение уровня части документа XPSXPS Document Part-Level Relationship URI типа отношенияRelationship Type URI
Определения цифровых подписейDigital Signature Definitions http://schemas.microsoft.com/xps/2005/06/signature-definitions
дискардконтролDiscardControl http://schemas.microsoft.com/xps/2005/06/discard-control
документструктуреDocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicketPrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
Требуемый ресурсRequired Resource http://schemas.microsoft.com/xps/2005/06/required-resource
Ограниченный шрифтRestricted Font 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://go.microsoft.com/fwlink/?LinkID=71255 .For more information about package relationships see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

Дополнительные сведения о XPS-документах см. в документации по формату Open XML (XPS) , доступной для загрузки по адресу https://go.microsoft.com/fwlink/?LinkID=67000 .For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at https://go.microsoft.com/fwlink/?LinkID=67000.

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

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

CreateRelationship(Uri, TargetMode, String, String)

Создает связь на уровне части между данным объектом PackagePart и указанным целевым объектом PackagePart или внешним ресурсом.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

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 целевой части.The URI of the target part.

targetMode
TargetMode

Одно из значений перечисления.One of the enumeration values. Например, Internal определяет целевую часть, находящуюся внутри Package, а External — целевой ресурс вне Package.For example, Internal if the target part is inside the Package; or External if the target is a resource outside the Package.

relationshipType
String

Роль связи.The role of the relationship.

id
String

Уникальный идентификатор связи.A unique ID for the relationship.

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

PackageRelationship

Связь на уровне части между данным объектом PackagePart и целевым объектом PackagePart или внешним ресурсом.The part-level relationship between this PackagePart to the target PackagePart or external resource.

Исключения

Данная часть была удалена.The part has been deleted.

-или--or- Объект Package не открыт (вызван метод Dispose(Boolean) или Close()).The Package is not open (Dispose(Boolean) or Close() has been called).

Параметр targetUri или relationshipType имеет значение null.targetUri or relationshipType is null.

Параметр targetMode не является допустимым значением перечисления TargetMode.The targetMode parameter is not a valid TargetMode enumeration value.

Часть, заданная параметром targetUri, является связью (целевым объектом связи не может быть другая связь).The part identified by the targetUri is a relationship (the target of a relationship cannot be another relationship).

-или--or- В качестве targetMode задано Internal, однако targetUri является абсолютным внешним URI.targetMode is specified as Internal but targetUri is an absolute external URI.

Пакет доступен только для чтения (добавление новой связи невозможно).The package is read-only (a new relationship cannot be added).

Параметр id не является допустимым идентификатором XML.id is not a valid XML identifier.

-или--or- Часть с указанным id уже существует.A part with the specified id already exists.

Комментарии

Связь уровня части определяет связь между этой частью и целевой частью или ресурсом.A part-level relationship defines an association between this part and a target part or resource. Отношение уровня части может быть одной из двух форм.A part-level relationship can be one of two forms.

В связи с частью исходная часть считается "владельцем" связи.In a part-relationship the source part is considered the "owner" of the relationship. При удалении исходной части также удаляются все связи, принадлежащие этой части.When the source part is deleted, all the relationships owned by the part are also deleted. Процесс создания или удаления связи физически не изменяет целевую часть или ресурс каким бы то ни было.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

id должен быть допустимым идентификатором XML.id must be a valid XML identifier. idТип — XSD: ID. он должен соответствовать соглашениям об именовании, указанным в спецификации XML-схемы часть 2: типы типов (см https://www.w3.org/TR/xmlschema-2/#ID .).The id type is xsd:ID and must follow the naming conventions prescribed in the XML Schema Part 2: Datatypes specification (see https://www.w3.org/TR/xmlschema-2/#ID).

CreateRelationshipМетод не изменяет физическое изменение исходной части или целевой части или ресурса каким либо образом.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

Целевой объект связи не может быть другой связью.The target of a relationship cannot be another relationship.

Если targetMode параметр имеет значение Internal , то параметр targetUri должен представлять собой относительный URI, сформированный в соответствии с универсальной спецификацией синтаксиса в стандарте URI RFC 3986 .If targetMode is specified as Internal, targetUri must be a relative URI that is formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. Внутренний относительный URI может быть либо абсолютным путем, который начинается с косой черты ("/"), например "/Page1.XAML", либо "/Images/picture4.jpg", либо относительным путем, таким как ".. /imagespicture1.jpg ", который разрешается в корневую папку пакета ("/") как базовый URI.The internal relative URI can be either an absolute path that starts with a forward slash ("/") character such as "/page1.xaml" or "/images/picture4.jpg", or a relative path such as "../imagespicture1.jpg" that resolves against the package root ("/") as the base URI.

Если targetMode параметр имеет значение External , то параметр targetUri может быть абсолютным или ОТносительным URI, сформированным в соответствии со спецификацией универсального синтаксиса URI RFC 3986 .If targetMode is specified as External, targetUri can be either an absolute or relative URI formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. " https://www.microsoft.com/page2.xml " — это пример абсолютного URI, который ссылается на внешний целевой ресурс "page2.xml"."https://www.microsoft.com/page2.xml" is an example of an absolute URI that references an external target resource "page2.xml". "Images/picture1.jpg" — это пример относительного URI, который также ссылается на внешний целевой ресурс "1.jpg", но он разрешается в URI самого пакета."images/picture1.jpg" is an example of a relative URI that also references an external target resource "1.jpg" but which resolves against the URI of the package itself.

relationshipTypeдолжен быть URI, сформированным согласно спецификации универсального синтаксиса URI RFC 3986 .relationshipType must be a URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. Различные типы пакетов могут определять разные типы отношений уровня части.Different package types can define different part-level relationship types. В следующей таблице показаны URI уровня части relationshipType , определенные для документов, которые соответствуют стандарту формата XPS.The following table shows the part-level relationshipType URIs defined for documents that conform to the Open XML Paper Specification (XPS).

Отношение уровня части документа XPSXPS Document Part-Level Relationship URI типа отношенияRelationship Type URI
Определения цифровых подписейDigital Signature Definitions http://schemas.microsoft.com/xps/2005/06/signature-definitions
дискардконтролDiscardControl http://schemas.microsoft.com/xps/2005/06/discard-control
документструктуреDocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicketPrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
Требуемый ресурсRequired Resource http://schemas.microsoft.com/xps/2005/06/required-resource
Ограниченный шрифтRestricted Font 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://go.microsoft.com/fwlink/?LinkID=71255 .For more information about package relationships see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

Дополнительные сведения о XPS-документах см. в документации по формату Open XML (XPS) , доступной для загрузки по адресу https://go.microsoft.com/fwlink/?LinkID=67000 .For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at https://go.microsoft.com/fwlink/?LinkID=67000.

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

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