PackagePart.CreateRelationship Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Cria uma relação de nível de parte entre isso PackagePart para um recurso externo ou de destino PackagePart especificado.
Sobrecargas
| Nome | Description |
|---|---|
| CreateRelationship(Uri, TargetMode, String) |
Cria uma relação de nível de parte entre isso PackagePart para um recurso externo ou de destino PackagePart especificado. |
| CreateRelationship(Uri, TargetMode, String, String) |
Cria uma relação de nível de parte entre isso PackagePart para um recurso externo ou de destino PackagePart especificado. |
Comentários
Uma relação de nível de parte define uma associação entre essa parte e uma parte ou recurso de destino. Uma relação de nível de parte pode ser uma das duas formas.
Entre uma origem PackagePart para um destino PackagePart dentro do Package.
Entre uma origem PackagePart para um recurso de destino fora do pacote.
Em uma relação de parte, a parte de origem é considerada o "proprietário" da relação. Quando a parte de origem é excluída, todas as relações pertencentes à parte também são excluídas. O processo de criação ou exclusão da relação não altera fisicamente a parte de destino ou o recurso de forma alguma.
O CreateRelationship método não altera fisicamente a parte de origem ou a parte de destino ou o recurso de qualquer forma.
O destino de uma relação não pode ser outra relação.
Para obter mais informações sobre relações de pacote, consulte a seção 1.3 da especificação OPC (Open Packaging Conventions) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Para obter mais informações sobre documentos XPS, consulte a XPS (Especificação de Papel Open XML) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
CreateRelationship(Uri, TargetMode, String)
Cria uma relação de nível de parte entre isso PackagePart para um recurso externo ou de destino PackagePart especificado.
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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationshipParâmetros
- targetUri
- Uri
O URI da parte de destino.
- targetMode
- 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
- String
A função da relação.
Retornos
A relação de nível de parte entre isso PackagePart com o recurso de destino PackagePart ou externo.
Exceções
targetUri ou relationshipType é null.
O targetMode parâmetro não é um valor de enumeração válido TargetMode .
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 URI externo absoluto.
O pacote é somente leitura (não é possível adicionar uma nova relação).
Comentários
Uma relação de nível de parte define uma associação entre essa parte e uma parte ou recurso de destino. Uma relação de nível de parte pode ser uma das duas formas.
- Entre uma origem PackagePart para um destino PackagePart dentro do Package.
- Entre uma origem PackagePart para um recurso de destino fora do pacote.
Em uma relação de parte, a parte de origem é considerada o "proprietário" da relação. Quando a parte de origem é excluída, todas as relações pertencentes à parte também são excluídas. O processo de criação ou exclusão da relação não altera fisicamente a parte de destino ou o recurso de forma alguma.
O CreateRelationship método não altera fisicamente a parte de origem ou a parte de destino ou o recurso de qualquer forma.
O destino de uma relação não pode ser outra relação.
Se targetMode for especificado como Internal, targetUri deverá ser um URI relativo que seja formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier)rfc 3986. O URI relativo interno pode ser um caminho absoluto que começa com um caractere de barra ("/") como "/page1.xaml" ou "/images/picture4.jpg", ou um caminho relativo como ".. /imagespicture1.jpg" que é resolvido na raiz do pacote ("/") como o URI base.
Se targetMode for especificado como External, targetUri poderá ser um URI absoluto ou relativo formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier)rfc 3986.
"https://www.microsoft.com/page2.xml" é um exemplo de um URI absoluto que faz referência a um recurso de destino externo"page2.xml". "images/picture1.jpg" é um exemplo de um URI relativo que também faz referência a um recurso de destino externo "1.jpg", mas que é resolvido em relação ao URI do próprio pacote.
relationshipTypedeve ser um URI formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier)rfc 3986. Diferentes tipos de pacote podem definir diferentes tipos de relação de nível de parte. A tabela a seguir mostra as URIs de nível relationshipType de parte definidas para documentos que estão em conformidade com a Especificação de Papel Open XML (XPS).
| Relação de Part-Level do documento XPS | URI do 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 |
| 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 restrita | 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 pacote, consulte a seção 1.3 da especificação OPC (Open Packaging Conventions) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Para obter mais informações sobre documentos XPS, consulte a XPS (Especificação de Papel Open XML) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
Confira também
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- Especificação de Convenções de Empacotamento Aberto
Aplica-se a
CreateRelationship(Uri, TargetMode, String, String)
Cria uma relação de nível de parte entre isso PackagePart para um recurso externo ou de destino PackagePart especificado.
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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationshipParâmetros
- targetUri
- Uri
O URI da parte de destino.
- targetMode
- 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
- String
A função da relação.
- id
- String
Uma ID exclusiva para a relação.
Retornos
A relação de nível de parte entre isso PackagePart com o recurso de destino PackagePart ou externo.
Exceções
targetUri ou relationshipType é null.
O targetMode parâmetro não é um valor de enumeração válido TargetMode .
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 URI externo absoluto.
O pacote é somente leitura (não é possível adicionar uma nova relação).
Comentários
Uma relação de nível de parte define uma associação entre essa parte e uma parte ou recurso de destino. Uma relação de nível de parte pode ser uma das duas formas:
- Entre uma origem PackagePart para um destino PackagePart dentro do Package.
- Entre uma origem PackagePart para um recurso de destino fora do pacote.
Em uma relação de parte, a parte de origem é considerada o "proprietário" da relação. Quando a parte de origem é excluída, todas as relações pertencentes à parte também são excluídas. O processo de criação ou exclusão da relação não altera fisicamente a parte de destino ou o recurso de forma alguma.
id deve ser um identificador XML válido. O id tipo é xsd:ID e deve seguir as convenções de nomenclatura prescritas no esquema XML Parte 2: especificação de tipos de dados (consulte https://www.w3.org/TR/xmlschema-2/#ID).
O CreateRelationship método não altera fisicamente a parte de origem ou a parte de destino ou o recurso de qualquer forma.
O destino de uma relação não pode ser outra relação.
Se targetMode for especificado como Internal, targetUri deverá ser um URI relativo que seja formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier)rfc 3986. O URI relativo interno pode ser um caminho absoluto que começa com um caractere de barra ("/") como "/page1.xaml" ou "/images/picture4.jpg", ou um caminho relativo como ".. /imagespicture1.jpg" que é resolvido na raiz do pacote ("/") como o URI base.
Se targetMode for especificado como External, targetUri poderá ser um URI absoluto ou relativo formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier)rfc 3986. "https://www.microsoft.com/page2.xml" é um exemplo de um URI absoluto que faz referência a um recurso de destino externo"page2.xml". "images/picture1.jpg" é um exemplo de um URI relativo que também faz referência a um recurso de destino externo "1.jpg", mas que é resolvido em relação ao URI do próprio pacote.
relationshipTypedeve ser um URI formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier)rfc 3986. Diferentes tipos de pacote podem definir diferentes tipos de relação de nível de parte. A tabela a seguir mostra as URIs de nível relationshipType de parte definidas para documentos que estão em conformidade com a Especificação de Papel Open XML (XPS).
| Relação de Part-Level do documento XPS | URI do 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 |
| 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 restrita | 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 pacote, consulte a seção 1.3 da especificação OPC (Open Packaging Conventions) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Para obter mais informações sobre documentos XPS, consulte o XPS (Open XML Paper Specification) disponível para download em https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
Confira também
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- Especificação de Convenções de Empacotamento Aberto