Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método PackagePart.CreateRelationship (Uri, TargetMode, String)

 

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

Namespace:   System.IO.Packaging
Assembly:  WindowsBase (em WindowsBase.dll)

public PackageRelationship CreateRelationship(
	Uri targetUri,
	TargetMode targetMode,
	string relationshipType
)

Parâmetros

targetUri
Type: System.Uri

O URI da parte de destino.

targetMode
Type: System.IO.Packaging.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
Type: System.String

A função do relacionamento.

Valor Retornado

Type: System.IO.Packaging.PackageRelationship

A relação em nível de parte entre esse PackagePart para o destino PackagePart ou recurso externo.

Exception Condition
InvalidOperationException

A parte foi excluída.

-ou-

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

ArgumentNullException

targetUri ou relationshipType é null.

ArgumentOutOfRangeException

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

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 é absoluto URI.

IOException

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

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

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

O CreateRelationship método não altera fisicamente a parte de origem, ou a parte de destino ou recursos de qualquer forma.

O destino 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 o RFC 3986 sintaxe genérica do identificador de recurso uniforme (URI) especificação.  O URI relativo interno pode ser um caminho absoluto que começa com uma barra ("/") caracteres, como "/ Page1" ou "/ images/picture4.jpg", ou um caminho relativo, como "... / imagespicture1.jpg "que resolve em relação a raiz do pacote ("/ ") como o URI de base.

Se targetMode for especificado como External, targetUri pode ser qualquer um absoluto ou relativo URI formado de acordo com o RFC 3986 sintaxe genérica do identificador de recurso uniforme (URI) especificação.  "http://www.microsoft.com/page2.xml" é um exemplo de um URI absoluto que faz referência a um recurso externo de destino "page2.xml". "images/picture1.jpg" é um exemplo de um URI relativo que também faz referência a um destino externo recurso "1.jpg" mas que resolve em relação ao URI do próprio pacote.

relationshipType deve ser um URI que é formado de acordo com o RFC 3986 sintaxe genérica do identificador de recurso uniforme (URI) especificação.  Tipos de pacote diferente podem definir tipos de relação em nível de parte diferentes. A tabela a seguir mostra o nível de parte relationshipType URIs definidos para documentos que estão em conformidade com a Open XML Paper Specification (XPS).

Relação em nível de parte documento XPS

Tipo de relação de URI

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

Recursos necessários

http://schemas.microsoft.com/XPS/2005/06/Required-Resource

Fonte restrito

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 pacotes, consulte a seção 1.3 do Open Packaging Conventions (OPC) especificação disponível para download em http://go.microsoft.com/fwlink/?LinkID=71255.

Para obter mais informações sobre XPS documentos consulte o Open XML Paper Specification (XPS) disponível para download em http://go.microsoft.com/fwlink/?LinkID=67000.

.NET Framework
Disponível desde 3.0
Retornar ao início
Mostrar: