Compartilhar via


PackagePart.CreateRelationship Método

Definição

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.

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

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

Exceções

A parte foi excluída.

-ou-

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

targetUri ou relationshipType é null.

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

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.

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.

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

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

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

Exceções

A parte foi excluída.

-ou-

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

targetUri ou relationshipType é null.

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

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.

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

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.

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

Aplica-se a