PackagePart.CreateRelationship Método

Definição

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Cria uma relação de nível de parte entre esse PackagePart a um PackagePart de destino ou recurso externo especificado.

Sobrecargas

CreateRelationship(Uri, TargetMode, String)	Cria uma relação de nível de parte entre esse PackagePart a um PackagePart de destino ou recurso externo especificado.
CreateRelationship(Uri, TargetMode, String, String)	Cria uma relação de nível de parte entre esse PackagePart a um PackagePart de destino ou recurso externo especificado.

Comentários

Uma relação de nível de parte define uma associação entre essa parte e uma parte ou recurso de destino. Uma relação de nível de parte pode ser uma das duas formas.

• Entre um PackagePart de origem a um PackagePart de destino dentro do Package.

• Entre um PackagePart de origem para um recurso de destino fora do pacote.

Em uma relação de parte, a parte de origem é considerada o "proprietário" da relação. Quando a parte de origem é excluída, todas as relações pertencentes à parte também são excluídas. O processo de criação ou exclusão da relação não altera fisicamente a parte de destino ou o recurso de forma alguma.

O método CreateRelationship não altera fisicamente a parte de origem ou a parte de destino ou o recurso de forma alguma.

O destino de uma relação não pode ser outra relação.

Para obter mais informações sobre relações de pacote, consulte a seção 1.3 da especificação de Open Packaging Conventions (OPC) disponível para download em .

Para obter mais informações sobre documentos XPS, consulte a XPS (Especificação de Papel Open XML) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

CreateRelationship(Uri, TargetMode, String)

Origem:

PackagePart.cs

Cria uma relação de nível de parte entre esse PackagePart a um PackagePart de destino ou recurso externo especificado.

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

Parâmetros

targetUri

Uri

O URI da parte de destino.

targetMode

TargetMode

Um dos valores de enumeração. Por exemplo, Internal se a parte de destino estiver dentro do Package; ou External se o destino for um recurso fora do Package.

relationshipType

String

A função da relação.

Retornos

PackageRelationship

A relação de nível de parte entre essa PackagePart ao PackagePart de destino ou ao recurso externo.

Exceções

InvalidOperationException

A parte foi excluída.

-ou-

O Package não está aberto (Dispose(Boolean) ou Close() foi chamado).

ArgumentNullException

targetUri ou relationshipType é null.

ArgumentOutOfRangeException

O parâmetro targetMode não é um valor de enumeração de TargetMode válido.

ArgumentException

A parte identificada pelo targetUri é uma relação (o destino de uma relação não pode ser outra relação).

-ou-

targetMode é especificado como Internal mas targetUri é um URI externo absoluto.

IOException

O pacote é somente leitura (não é possível adicionar uma nova relação).

Comentários

Uma relação de nível de parte define uma associação entre essa parte e uma parte ou recurso de destino. Uma relação de nível de parte pode ser uma das duas formas.

• Entre um PackagePart de origem a um PackagePart de destino dentro do Package.

• Entre um PackagePart de origem para um recurso de destino fora do pacote.

Em uma relação de parte, a parte de origem é considerada o "proprietário" da relação. Quando a parte de origem é excluída, todas as relações pertencentes à parte também são excluídas. O processo de criação ou exclusão da relação não altera fisicamente a parte de destino ou o recurso de forma alguma.

O método CreateRelationship não altera fisicamente a parte de origem ou a parte de destino ou o recurso de forma alguma.

O destino de uma relação não pode ser outra relação.

Se targetMode for especificado como Internal, targetUri deverá ser um URI relativo que seja formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier) do RFC 3986. 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 é resolvido na raiz do pacote ("/") como o URI base.

Se for especificado como , poderá ser um URI absoluto ou relativo formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier) do RFC 3986. "https://www.microsoft.com/page2.xml" é um exemplo de um URI absoluto que faz referência a um recurso de destino externo"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.

deve ser um URI formado de acordo com a especificação de sintaxe genérica RFC 3986Uniform Resource Identifier (URI). Diferentes tipos de pacote podem definir diferentes tipos de relação de nível de parte. A tabela a seguir mostra os URIs de de nível parcial definidos para documentos que estão em conformidade com oXPS (Open XML Paper Specification) .

Relação de Part-Level do documento XPS	URI do tipo de relação
Definições de assinatura digital	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
PrintTicket	http://schemas.microsoft.com/xps/2005/06/printticket
Recurso Necessário	http://schemas.microsoft.com/xps/2005/06/required-resource
Fonte restrita	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

Para obter mais informações sobre relações de pacote, consulte a seção 1.3 da especificação de Open Packaging Conventions (OPC) disponível para download em .

Para obter mais informações sobre documentos XPS, consulte o XPS (Open XML Paper Specification) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

Confira também

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• de Especificação de Convenções de Empacotamento Aberto

CreateRelationship(Uri, TargetMode, String, String)

Origem:

PackagePart.cs

Cria uma relação de nível de parte entre esse PackagePart a um PackagePart de destino ou recurso externo especificado.

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

Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationship

Parâmetros

targetUri

Uri

O URI da parte de destino.

targetMode

TargetMode

Um dos valores de enumeração. Por exemplo, Internal se a parte de destino estiver dentro do Package; ou External se o destino for um recurso fora do Package.

relationshipType

String

A função da relação.

id

String

Uma ID exclusiva para a relação.

Retornos

PackageRelationship

A relação de nível de parte entre essa PackagePart ao PackagePart de destino ou ao recurso externo.

Exceções

InvalidOperationException

A parte foi excluída.

-ou-

O Package não está aberto (Dispose(Boolean) ou Close() foi chamado).

ArgumentNullException

targetUri ou relationshipType é null.

ArgumentOutOfRangeException

O parâmetro targetMode não é um valor de enumeração de TargetMode válido.

ArgumentException

A parte identificada pelo targetUri é uma relação (o destino de uma relação não pode ser outra relação).

-ou-

targetMode é especificado como Internal mas targetUri é um URI externo absoluto.

IOException

O pacote é somente leitura (não é possível adicionar uma nova relação).

XmlException

id não é um identificador XML válido.

-ou-

Já existe uma parte com o id especificado.

Comentários

Uma relação de nível de parte define uma associação entre essa parte e uma parte ou recurso de destino. Uma relação de nível de parte pode ser uma das duas formas.

• Entre um PackagePart de origem a um PackagePart de destino dentro do Package.

• Entre um PackagePart de origem para um recurso de destino fora do pacote.

Em uma relação de parte, a parte de origem é considerada o "proprietário" da relação. Quando a parte de origem é excluída, todas as relações pertencentes à parte também são excluídas. O processo de criação ou exclusão da relação não altera fisicamente a parte de destino ou o recurso de forma alguma.

id deve ser um identificador XML válido. O tipo id é xsd:ID e deve seguir as convenções de nomenclatura prescritas no esquema XML parte 2: especificação de de tipos de dados (consulte https://www.w3.org/TR/xmlschema-2/#ID).

O método CreateRelationship não altera fisicamente a parte de origem ou a parte de destino ou o recurso de forma alguma.

O destino de uma relação não pode ser outra relação.

Se targetMode for especificado como Internal, targetUri deverá ser um URI relativo que seja formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier) do RFC 3986. 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 é resolvido na raiz do pacote ("/") como o URI base.

Se for especificado como , poderá ser um URI absoluto ou relativo formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier) do RFC 3986. "https://www.microsoft.com/page2.xml" é um exemplo de um URI absoluto que faz referência a um recurso de destino externo"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.

deve ser um URI formado de acordo com a especificação de sintaxe genérica RFC 3986Uniform Resource Identifier (URI). Diferentes tipos de pacote podem definir diferentes tipos de relação de nível de parte. A tabela a seguir mostra os URIs de de nível parcial definidos para documentos que estão em conformidade com oXPS (Open XML Paper Specification) .

Relação de Part-Level do documento XPS	URI do tipo de relação
Definições de assinatura digital	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
PrintTicket	http://schemas.microsoft.com/xps/2005/06/printticket
Recurso Necessário	http://schemas.microsoft.com/xps/2005/06/required-resource
Fonte restrita	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

Para obter mais informações sobre relações de pacote, consulte a seção 1.3 da especificação de Open Packaging Conventions (OPC) disponível para download em .

Para obter mais informações sobre documentos XPS, consulte o XPS (Open XML Paper Specification) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

Confira também

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• de Especificação de Convenções de Empacotamento Aberto