PackagePart.CreateRelationship Метод

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

Параметры

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

PackageRelationship

Связь на уровне части между данным объектом PackagePart и целевым объектом PackagePart или внешним ресурсом.The part-level relationship between this PackagePart to the 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.

• Между источником PackagePart и целевым объектом в PackagePart Package .Between a source PackagePart to a target PackagePart inside the Package.

• Между источником PackagePart и целевым ресурсом за пределами пакета.Between a source PackagePart to a target resource outside the package.

В связи с частью исходная часть считается "владельцем" связи.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
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Спецификация Open Packaging ConventionsOpen Packaging Conventions Specification

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

Параметры

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

PackageRelationship

Связь на уровне части между данным объектом PackagePart и целевым объектом PackagePart или внешним ресурсом.The part-level relationship between this PackagePart to the 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.

• Между источником PackagePart и целевым объектом в PackagePart Package .Between a source PackagePart to a target PackagePart inside the Package.

• Между источником PackagePart и целевым ресурсом за пределами пакета.Between a source PackagePart to a target resource outside the package.

В связи с частью исходная часть считается "владельцем" связи.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.

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

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Спецификация Open Packaging ConventionsOpen Packaging Conventions Specification