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

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

Cria uma relação de nível de pacote a uma parte com um determinado URI, o modo de destino, o tipo de relação, e identificador (ID).

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

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

Parâmetros

targetUri
Tipo: System.Uri
O uniform resource identifier (URI) parte de destino.
targetMode
Tipo: System.IO.Packaging.TargetMode
Indica se a parte de destino é Internal ou External para o pacote.
relationshipType
Tipo: System.String
Um URI que define exclusivamente a função do relacionamento.
id
Tipo: System.String
Um identificador exclusivo do XML.

Valor de retorno

Tipo: System.IO.Packaging.PackageRelationship
A relação de nível de pacote para a parte especificada.

ExceçãoCondição
ArgumentNullException

targetUrior relationshipType is null.

ArgumentException

The targetUri part is a PackageRelationship, or targetMode is Internal and targetUri is an absolute URI.

ArgumentOutOfRangeException

O valor de targetMode não é válido.

ObjectDisposedException

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

IOException

O pacote é somente leitura.

XmlException

idnão é um identificador válido do XML; ou uma parte com a versão especificada id já ocorre no pacote.

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

  • Entre um Package para uma parte de destino no pacote.

  • Entre um Package a um recurso de destino fora do pacote.

Em um relacionamento de pacote, o pacote é considerado "proprietário" da relação. Quando o pacote é excluído, todas as relações de propriedade do pacote também serão excluídas.

CreateRelationship não alterar fisicamente a parte de destino ou o recurso de forma alguma.

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

iddeve ser um identificador XML válido. O id é o xsd: ID de tipo e devem seguir as convenções de nomenclatura prescritas no XML esquema parte 2: especificação de tipos de dados (consulte http://www.w3.org/TR/xmlschema-2/#ID).

Se id é especificado como null um ID exclusivo será gerado automaticamente. Um id especificado por um vazio não é válido.

Se targetMode é especificado como Internal, targetUri deve ser um URI relativo que é formado de acordo com o RFC 3986 a especificação de sintaxe genérica do identificador de recursos uniforme (URI). 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 relativa URI formado de acordo com o RFC 3986 a especificação de sintaxe genérica do identificador de recursos uniforme (URI). " 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 3986 a especificação de sintaxe genérica do identificador de recursos uniforme (URI). A tabela a seguir mostra o nível de pacote relationshipType URIs definido pela especificação Open Packaging Conventions (OPC).

Relação em nível de pacote

Tipo de relacionamento URI

Propriedades de núcleo

http://schemas.openxmlformats.org/Package/2006/Relationships/meta dados, core-propriedades

Assinatura digital

http://schemas.openxmlformats.org/Package/2006/Relationships/digit al-assinatura/assinatura

Certificado de assinatura digital

http://schemas.openxmlformats.org/Package/2006/Relationships/digit al-/ certificado de assinatura

Origem da assinatura digital

http://schemas.openxmlformats.org/Package/2006/Relationships/digit al-/ origem da assinatura

Miniatura

dados de http://schemas.openxmlformats.org/Package/2006/Relationships/meta/miniatura

Para obter informações adicionais sobre pacotes e relacionamentos de pacote, consulte a seção 1.3 da especificação Open Packaging Conventions (OPC) disponível para download em http://go.microsoft.com/fwlink/?LinkID=71255.

O exemplo a seguir ilustra como usar CreateRelationship para criar um PackageRelationship entre um Package e uma parte do documento raiz. Para obter o exemplo completo, consulte escrevendo uma amostra do pacote.


// Add the Document part to the Package
PackagePart packagePartDocument =
    package.CreatePart(partUriDocument,
                   System.Net.Mime.MediaTypeNames.Text.Xml);

// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
       documentPath, FileMode.Open, FileAccess.Read))
{
    CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.

// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
                           TargetMode.Internal,
                           PackageRelationshipType);


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, 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.

Contribuições da comunidade

ADICIONAR
Mostrar:
© 2015 Microsoft