CreateRelationship Método (Uri, TargetMode, String)
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)

.NET Framework (current version)
 

Cria uma relação no nível da parte com um URI, um modo de destino, e um tipo de relação dados.

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

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

Parâmetros

targetUri

uniform resource identifier (URI) da parte de destino.

targetMode

Indica se a parte de destino é Internal ou External ao pacote.

relationshipType

UM URI que define exclusivamente a função da relação.

Valor de retorno

Type: System.IO.Packaging.PackageRelationship

A relação de nível de pacote à parte especificada.

Exception Condition
ArgumentNullException

targetUri ou relationshipType são null.

ArgumentException

A parte de targetUri é PackageRelationship, ou targetMode é Internal e targetUri é um URI absoluto.

ArgumentOutOfRangeException

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

ObjectDisposedException

O pacote não estiver abertoDispose (ou Close foram chamados).

IOException

O pacote é somente leitura.

Uma relação de nível de pacote define uma associação entre o pacote e uma parte de destino ou recurso associado. Uma relação de nível de pacote pode ser um dos dois formulários.

  • Entre Package a parte de destino no pacote.

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

Uma relação no o pacote é considerado “owner” 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 altera a parte fisicamente ou o recurso de destino de nenhuma forma.

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

Se targetMode é especificado como Internal, targetUri deve ser um URI relativo que é formado de acordo com RFC 3986 a especificação da sintaxe do Uniform Resource Identifier (URI). O URI relativo interno pode ser um caminho absoluto que começa com uma barra (“/") caractere como “/page1.xaml” ou “/images/picture4.jpg”, ou um caminho relativo como “. /imagespicture1.jpg” que resolve no pacote enraízam (“/") como o URI base.

Se targetMode é especificado como External, targetUri pode ser um URI absoluto ou relativo formado de acordo com RFC 3986 a especificação da sintaxe do Uniform Resource Identifier (URI). “http://www.microsoft.com/page2.xml” é um exemplo de um URI absoluto que faz referência a um recurso externo “page2.xml” de destino. as imagens picture1.jpg “/” é um exemplo de um URI relativo que também faz referência a um recurso externo “1.jpg” de destino mas que resolve no URI do próprio pacote.

relationshipType deve ser URI que é formado de acordo RFC 3986 com a especificação da sintaxe do Uniform Resource Identifier (URI). A tabela a seguir mostra os uris de relationshipType de nível de pacote definidos pela especificação aberta empacotando de (OPC) as convenções.

Relação de nível de pacote

URI do tipo de relação

Propriedades principais

dados/propriedades do http://schemas.openxmlformats.org/package/2006/relationships/meta

Assinatura digital

al- assinatura/assinatura do http://schemas.openxmlformats.org/package/2006/relationships/digit

Certificado de assinatura digital

al- assinatura/certificado do http://schemas.openxmlformats.org/package/2006/relationships/digit

Origem da assinatura digital

al- assinatura/origem do http://schemas.openxmlformats.org/package/2006/relationships/digit

Miniatura

dados/miniatura do http://schemas.openxmlformats.org/package/2006/relationships/meta

Para obter mais informações sobre as relações do pacote e de pacote, consulte a seção 1,3 da especificação aberta empacotando de (OPC) as convenções disponível para download em http://go.microsoft.com/fwlink/?LinkID=71255.

O exemplo a seguir ilustra como usar CreateRelationship para criar PackageRelationship entre Package e um documento parte da raiz. Para o exemplo completo, consulte Escrevendo um exemplo de 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
Disponível desde 3.0
Retornar ao topo
Mostrar:
© 2016 Microsoft