PackagePart.CreateRelationship Método

Definição

Espaço de Nomes:: System.IO.Packaging

Assemblagem:: WindowsBase.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Cria uma relação a nível de parte entre isto PackagePart e um alvo PackagePart específico ou recurso externo.

Sobrecargas

Name	Description
CreateRelationship(Uri, TargetMode, String)	Cria uma relação a nível de parte entre isto PackagePart e um alvo PackagePart específico ou recurso externo.
CreateRelationship(Uri, TargetMode, String, String)	Cria uma relação a nível de parte entre isto PackagePart e um alvo PackagePart específico ou recurso externo.

Observações

Uma relação ao nível da parte define uma associação entre esta parte e uma parte ou recurso alvo. Uma relação a nível parcial pode ser uma de duas formas.

Entre uma fonte PackagePart e um alvo PackagePart dentro do Package.
Entre uma fonte PackagePart e um recurso alvo fora do pacote.

Numa relação parcial, a parte fonte é considerada o "dono" da relação. Quando a parte de origem é eliminada, todas as relações pertencentes à peça também são eliminadas. O processo de criar ou eliminar a relação não altera fisicamente a parte ou recurso alvo de forma alguma.

O CreateRelationship método não altera fisicamente nem a parte fonte, nem a parte ou recurso alvo de forma alguma.

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

Para mais informações sobre relações com as embalagens, consulte a secção 1.3 da especificação Open Packaging Conventions (OPC ) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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

CreateRelationship(Uri, TargetMode, String)

Cria uma relação a nível de parte entre isto PackagePart e um alvo PackagePart específico ou recurso externo.

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

targetMode: TargetMode

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

relationshipType: String

O papel da relação.

Devoluções

PackageRelationship

A relação ao nível parcial entre isto PackagePart e o alvo PackagePart ou recurso externo.

Exceções

InvalidOperationException

A parte foi apagada.

-ou-

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

ArgumentNullException

targetUri ou relationshipType é null.

ArgumentOutOfRangeException

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

ArgumentException

A parte identificada por o targetUri é uma relação (o alvo 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 é apenas leitura (não pode ser adicionada uma nova relação).

Observações

Uma relação ao nível da parte define uma associação entre esta parte e uma parte ou recurso alvo. Uma relação a nível parcial pode ser uma de duas formas.

Entre uma fonte PackagePart e um alvo PackagePart dentro do Package.
Entre uma fonte PackagePart e um recurso alvo fora do pacote.

O CreateRelationship método não altera fisicamente nem a parte fonte, nem a parte ou recurso alvo de forma alguma.

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

Se targetMode for especificado como Internal, targetUri deve ser um URI relativo formado de acordo com a especificação de Sintaxe Genérica do Identificador Uniforme de Recursos (URI) do RFC 3986. O URI relativo interno pode ser um caminho absoluto que começa com uma barra direta ("/") como "/page1.xaml" ou "/images/picture4.jpg", ou um caminho relativo como ".. /imagespicture1.jpg" que resolve contra a raiz do pacote ("/") como o URI base.

Se targetMode for especificado como External, targetUri pode ser um URI absoluto ou relativo formado de acordo com a especificação de Sintaxe Genérica do Identificador Uniforme de Recursos (URI) do RFC 3986. "https://www.microsoft.com/page2.xml" é um exemplo de um URI absoluto que faz referência a um recurso alvo externo "page2.xml". "images/picture1.jpg" é um exemplo de URI relativo que também faz referência a um recurso alvo externo "1.jpg", mas que resolve contra o URI do próprio pacote.

relationshipType deve ser um URI formado de acordo com a especificação de sintaxe genérica do RFC 3986Uniform Resource Identifier (URI ). Diferentes tipos de pacotes podem definir diferentes tipos de relações ao nível das partes. A tabela seguinte mostra os URIs a nível relationshipType de parte definidos para documentos que cumprem a Especificação do Papel Open XML (XPS).

Relação Part-Level Documento XPS	URI de 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`
DocumentEstrutura	`http://schemas.microsoft.com/xps/2005/06/documentstructure`
Bilhete Impresso	`http://schemas.microsoft.com/xps/2005/06/printticket`
Recursos Necessários	`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`
Fragmentos da História	`http://schemas.microsoft.com/xps/2005/06/storyfragments`

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

Ver também

Aplica-se a

CreateRelationship(Uri, TargetMode, String, String)

Cria uma relação a nível de parte entre isto PackagePart e um alvo PackagePart específico ou recurso externo.

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

targetMode: TargetMode

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

relationshipType: String

O papel da relação.

id: String

Um ID único para a relação.

Devoluções

PackageRelationship

A relação ao nível parcial entre isto PackagePart e o alvo PackagePart ou recurso externo.

Exceções

InvalidOperationException

A parte foi apagada.

-ou-

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

ArgumentNullException

targetUri ou relationshipType é null.

ArgumentOutOfRangeException

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

ArgumentException

A parte identificada por o targetUri é uma relação (o alvo 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 é apenas leitura (não pode ser adicionada uma nova relação).

XmlException

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

-ou-

Já existe uma peça com o especificado id .

Observações

Uma relação ao nível da parte define uma associação entre esta parte e uma parte ou recurso alvo. Uma relação ao nível de partes pode ser de duas formas:

Entre uma fonte PackagePart e um alvo PackagePart dentro do Package.
Entre uma fonte PackagePart e um recurso alvo fora do pacote.

id deve ser um identificador XML válido. O id tipo é xsd:ID e deve seguir as convenções de nomenclatura prescritas na especificação do XML Schema Parte 2: Tipos de Dados (ver https://www.w3.org/TR/xmlschema-2/#ID).

O CreateRelationship método não altera fisicamente nem a parte fonte, nem a parte ou recurso alvo de forma alguma.

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

Se targetMode for especificado como External, targetUri pode ser um URI absoluto ou relativo formado de acordo com a especificação de Sintaxe Genérica do Identificador Uniforme de Recursos (URI) do RFC 3986. "https://www.microsoft.com/page2.xml" é um exemplo de um URI absoluto que faz referência a um recurso alvo externo "page2.xml". "images/picture1.jpg" é um exemplo de URI relativo que também faz referência a um recurso alvo externo "1.jpg", mas que resolve contra o URI do próprio pacote.

Relação Part-Level Documento XPS	URI de 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`
DocumentEstrutura	`http://schemas.microsoft.com/xps/2005/06/documentstructure`
Bilhete Impresso	`http://schemas.microsoft.com/xps/2005/06/printticket`
Recursos Necessários	`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`
Fragmentos da História	`http://schemas.microsoft.com/xps/2005/06/storyfragments`

Ver também

Aplica-se a

Comentários

Esta página foi útil?