Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original
Este tópico ainda não foi avaliado como - Avalie este tópico

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

Cria uma relação de nível de parte entre esta 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
Tipo: System.Uri
O URI parte de destino.
targetMode
Tipo: 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
Tipo: System.String
A função do relacionamento.

Valor de retorno

Tipo: System.IO.Packaging.PackageRelationship
A relação de nível de parte entre esta PackagePart para o destino PackagePart ou recurso externo.
ExceçãoCondição
InvalidOperationException

A parte foi excluída.

-ou-

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

ArgumentNullException

targetUrior relationshipType is 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 é um absoluto externo URI.

IOException

O pacote é somente leitura (não é possível adicionar um novo relacionamento).

Um relacionamento de nível de parte define uma associação entre esta 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, todos os relacionamentos pertencentes a parte também serão excluídos. O processo de criação ou exclusão de relação não alteram fisicamente a parte de destino ou o recurso de forma alguma.

O CreateRelationship método não alterar fisicamente a parte de origem, ou a parte de destino ou recurso de qualquer maneira.

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

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

Se targetMode é especificado como External, targetUri pode ser uma exigência de absoluta ou URI relativo é formado de acordo com o RFC 3986Sintaxe genérica do identificador de recursos uniforme (URI) especificação.  " http://www.microsoft.com/Page2.xml"é um exemplo de um URI absoluto que faça referência a um recurso de destino externos"page2.xml". " imagens/Picture1"é um exemplo de um URI relativo que também faz referência a um destino externo recurso"1.jpg", mas que resolve contra o URI do pacote em si.

relationshipTypedeve ser um URI que é formado de acordo com o RFC 3986Sintaxe genérica do identificador de recursos uniforme (URI) especificação.  Diferentes tipos de encapsulamentos podem definir tipos de relacionamento diferente do nível de parte. A tabela a seguir mostra o nível de parte relationshipType URIs definido para documentos que estão de acordo com o Open XML Paper Specification ((XPS)).

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

Tipo de relacionamento 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

Recurso necessário

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

Fonte com restrições

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 relacionamentos de pacote consulte a seção 1.3 a Open Packaging convenções (OPC) especificação disponível para download em http://go.microsoft.com/fwlink/?LinkID=71255.

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

.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.
Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2014 Microsoft. Todos os direitos reservados.