PackagePart.CreateRelationship Método

Referência

Definição

Namespace:: System.IO.Packaging

Assembly:: System.IO.Packaging.dll

Assembly:: WindowsBase.dll

Pacote:: System.IO.Packaging v8.0.1

Pacote:: System.IO.Packaging v9.0.0-rc.2.24473.5

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Origem:: PackagePart.cs

Origem:: PackagePart.cs

Origem:: PackagePart.cs

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.

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

Aplica-se a

CreateRelationship(Uri, TargetMode, String, String)

Origem:: PackagePart.cs

Origem:: PackagePart.cs

Origem:: PackagePart.cs

Origem:: PackagePart.cs

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);

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.

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 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.

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 .

Confira também

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

Aplica-se a

Compartilhar via

PackagePart.CreateRelationship Método

Definição

Sobrecargas

Comentários

CreateRelationship(Uri, TargetMode, String)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

CreateRelationship(Uri, TargetMode, String, String)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Recursos adicionais