PackagePart.CreateRelationship Método

Definição

Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo especificado.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

Sobrecargas

CreateRelationship(Uri, TargetMode, String)

Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo especificado.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

CreateRelationship(Uri, TargetMode, String, String)

Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo especificado.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

Comentários

Uma relação de nível de parte define uma associação entre esta parte e uma parte ou recurso de destino.A part-level relationship defines an association between this part and a target part or resource. Uma relação em nível de parte pode ser uma das duas formas.A part-level relationship can be one of two forms.

Em uma relação entre partes, a parte de origem é considerada o "proprietário" da relação.In a part-relationship the source part is considered the "owner" of the relationship. Quando a parte de origem é excluída, todas as relações de propriedade da parte também são excluídas.When the source part is deleted, all the relationships owned by the part are also deleted. O processo de criação ou exclusão da relação não altera fisicamente a parte ou o recurso de destino de forma alguma.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

O método CreateRelationship não altera fisicamente a parte de origem nem a parte de destino ou o recurso de forma alguma.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

O destino de uma relação não pode ser outra relação.The target of a relationship cannot be another relationship.

Para obter mais informações sobre relações de pacote, consulte a seção 1,3 da especificação do OPC (Open Packaging Conventions) disponível para download em 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.

Para obter mais informações sobre documentos XPS, consulte Open XML Paper Specification (XPS) disponível para download em 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)

Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo especificado.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

Parâmetros

targetUri
Uri

O URI da parte de destino.The URI of the target part.

targetMode
TargetMode

Um dos valores de enumeração.One of the enumeration values. Por exemplo, Internal se a parte de destino estiver dentro do Package ou External se o destino for um recurso fora do 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

A função da relação.The role of the relationship.

Retornos

A relação de nível de parte entre este PackagePart para o PackagePart de destino ou recurso externo.The part-level relationship between this PackagePart to the target PackagePart or external resource.

Exceções

A parte foi excluída.The part has been deleted.

- ou --or- O Package não está aberto (Dispose(Boolean) ou Close() foi chamado).The Package is not open (Dispose(Boolean) or Close() has been called).

targetUri ou relationshipType é null.targetUri or relationshipType is null.

O parâmetro targetMode não é um valor de enumeração TargetMode válido.The targetMode parameter is not a valid TargetMode enumeration value.

A parte identificada pelo targetUri é uma relação (o destino de uma relação não pode ser outra relação).The part identified by the targetUri is a relationship (the target of a relationship cannot be another relationship).

- ou --or- targetMode é especificado como Internal, mas targetUri é um URI externo absoluto.targetMode is specified as Internal but targetUri is an absolute external URI.

O pacote é somente leitura (não é possível adicionar uma nova relação).The package is read-only (a new relationship cannot be added).

Comentários

Uma relação de nível de parte define uma associação entre esta parte e uma parte ou recurso de destino.A part-level relationship defines an association between this part and a target part or resource. Uma relação em nível de parte pode ser uma das duas formas.A part-level relationship can be one of two forms.

Em uma relação entre partes, a parte de origem é considerada o "proprietário" da relação.In a part-relationship the source part is considered the "owner" of the relationship. Quando a parte de origem é excluída, todas as relações de propriedade da parte também são excluídas.When the source part is deleted, all the relationships owned by the part are also deleted. O processo de criação ou exclusão da relação não altera fisicamente a parte ou o recurso de destino de forma alguma.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

O método CreateRelationship não altera fisicamente a parte de origem nem a parte de destino ou o recurso de forma alguma.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

O destino de uma relação não pode ser outra relação.The target of a relationship cannot be another relationship.

Se targetMode for especificado como Internal, targetUri deverá ser um URI relativo que é formado de acordo com a especificação de sintaxe genérica RFC 3986 Uniform Resource Identifier (URI) .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. O URI relativo interno pode ser um caminho absoluto que começa com um caractere de barra ("/"), como "/Page1.xaml" ou "/images/picture4.jpg", ou um caminho relativo, como ".. /imagespicture1.jpg "que resolve em relação à raiz do pacote ("/") como o URI de base.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.

Se targetMode for especificado como External, targetUri poderá ser um URI absoluto ou relativo formado de acordo com a especificação de sintaxe genérica RFC 3986 Uniform Resource Identifier (URI) .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" é um exemplo de um URI absoluto que faz referência a um recurso de destino externo "página2. 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" é um exemplo de um URI relativo que também faz referência a um recurso de destino externo "1. jpg", mas que é resolvido em relação ao URI do próprio pacote."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 deve ser um URI formado de acordo com a especificação de sintaxe genérica RFC 3986 Uniform Resource Identifier (URI) .relationshipType must be a URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. Diferentes tipos de pacote podem definir diferentes tipos de relacionamento em nível de parte.Different package types can define different part-level relationship types. A tabela a seguir mostra os URIs de relationshipType em nível de parte definidos para documentos que estão em conformidade com o XPS (Open XML Paper Specification).The following table shows the part-level relationshipType URIs defined for documents that conform to the Open XML Paper Specification (XPS).

Relação de nível de parte do documento XPSXPS Document Part-Level Relationship URI do tipo de relaçãoRelationship Type URI
Definições de assinatura digitalDigital Signature Definitions http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControlDiscardControl http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructureDocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicketPrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
Recurso necessárioRequired Resource http://schemas.microsoft.com/xps/2005/06/required-resource
Fonte restritaRestricted Font http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPartStartPart http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragmentsStoryFragments http://schemas.microsoft.com/xps/2005/06/storyfragments

Para obter mais informações sobre relações de pacote, consulte a seção 1,3 da especificação do OPC (Open Packaging Conventions) disponível para download em 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.

Para obter mais informações sobre documentos XPS, consulte Open XML Paper Specification (XPS) disponível para download em 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.

Veja também

CreateRelationship(Uri, TargetMode, String, String)

Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo especificado.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);
member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string * string -> System.IO.Packaging.PackageRelationship

Parâmetros

targetUri
Uri

O URI da parte de destino.The URI of the target part.

targetMode
TargetMode

Um dos valores de enumeração.One of the enumeration values. Por exemplo, Internal se a parte de destino estiver dentro do Package ou External se o destino for um recurso fora do 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

A função da relação.The role of the relationship.

id
String

Uma ID exclusiva para a relação.A unique ID for the relationship.

Retornos

A relação de nível de parte entre este PackagePart para o PackagePart de destino ou recurso externo.The part-level relationship between this PackagePart to the target PackagePart or external resource.

Exceções

A parte foi excluída.The part has been deleted.

- ou --or- O Package não está aberto (Dispose(Boolean) ou Close() foi chamado).The Package is not open (Dispose(Boolean) or Close() has been called).

targetUri ou relationshipType é null.targetUri or relationshipType is null.

O parâmetro targetMode não é um valor de enumeração TargetMode válido.The targetMode parameter is not a valid TargetMode enumeration value.

A parte identificada pelo targetUri é uma relação (o destino de uma relação não pode ser outra relação).The part identified by the targetUri is a relationship (the target of a relationship cannot be another relationship).

- ou --or- targetMode é especificado como Internal, mas targetUri é um URI externo absoluto.targetMode is specified as Internal but targetUri is an absolute external URI.

O pacote é somente leitura (não é possível adicionar uma nova relação).The package is read-only (a new relationship cannot be added).

id não é um identificador XML válido.id is not a valid XML identifier.

- ou --or- Já existe uma parte com o id especificado.A part with the specified id already exists.

Comentários

Uma relação de nível de parte define uma associação entre esta parte e uma parte ou recurso de destino.A part-level relationship defines an association between this part and a target part or resource. Uma relação em nível de parte pode ser uma das duas formas.A part-level relationship can be one of two forms.

Em uma relação entre partes, a parte de origem é considerada o "proprietário" da relação.In a part-relationship the source part is considered the "owner" of the relationship. Quando a parte de origem é excluída, todas as relações de propriedade da parte também são excluídas.When the source part is deleted, all the relationships owned by the part are also deleted. O processo de criação ou exclusão da relação não altera fisicamente a parte ou o recurso de destino de forma alguma.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

id deve ser um identificador XML válido.id must be a valid XML identifier. O tipo de id é xsd: ID e deve seguir as convenções de nomenclatura prescritas no esquema XML parte 2: especificação de datatypes (consulte 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).

O método CreateRelationship não altera fisicamente a parte de origem nem a parte de destino ou o recurso de forma alguma.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

O destino de uma relação não pode ser outra relação.The target of a relationship cannot be another relationship.

Se targetMode for especificado como Internal, targetUri deverá ser um URI relativo que é formado de acordo com a especificação de sintaxe genérica RFC 3986 Uniform Resource Identifier (URI) .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. O URI relativo interno pode ser um caminho absoluto que começa com um caractere de barra ("/"), como "/Page1.xaml" ou "/images/picture4.jpg", ou um caminho relativo, como ".. /imagespicture1.jpg "que resolve em relação à raiz do pacote ("/") como o URI de base.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.

Se targetMode for especificado como External, targetUri poderá ser um URI absoluto ou relativo formado de acordo com a especificação de sintaxe genérica RFC 3986 Uniform Resource Identifier (URI) .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" é um exemplo de um URI absoluto que faz referência a um recurso de destino externo "página2. 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" é um exemplo de um URI relativo que também faz referência a um recurso de destino externo "1. jpg", mas que é resolvido em relação ao URI do próprio pacote."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 deve ser um URI formado de acordo com a especificação de sintaxe genérica RFC 3986 Uniform Resource Identifier (URI) .relationshipType must be a URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. Diferentes tipos de pacote podem definir diferentes tipos de relacionamento em nível de parte.Different package types can define different part-level relationship types. A tabela a seguir mostra os URIs de relationshipType em nível de parte definidos para documentos que estão em conformidade com o XPS (Open XML Paper Specification).The following table shows the part-level relationshipType URIs defined for documents that conform to the Open XML Paper Specification (XPS).

Relação de nível de parte do documento XPSXPS Document Part-Level Relationship URI do tipo de relaçãoRelationship Type URI
Definições de assinatura digitalDigital Signature Definitions http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControlDiscardControl http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructureDocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicketPrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
Recurso necessárioRequired Resource http://schemas.microsoft.com/xps/2005/06/required-resource
Fonte restritaRestricted Font http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPartStartPart http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragmentsStoryFragments http://schemas.microsoft.com/xps/2005/06/storyfragments

Para obter mais informações sobre relações de pacote, consulte a seção 1,3 da especificação do OPC (Open Packaging Conventions) disponível para download em 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.

Para obter mais informações sobre documentos XPS, consulte Open XML Paper Specification (XPS) disponível para download em 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.

Veja também

Aplica-se a