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 esta PackagePart para uma PackagePart de destino ou recurso externo especificado.
Sobrecargas
| CreateRelationship(Uri, TargetMode, String) |
Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo especificado. |
| CreateRelationship(Uri, TargetMode, String, String) |
Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo 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 parcial pode ser uma das duas formas.
Entre uma origem PackagePart e um destino PackagePart dentro do Package.
Entre uma origem PackagePart e um recurso de destino fora do pacote.
Em uma relação parcial, 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 ou o recurso de destino de forma alguma.
O CreateRelationship método não altera fisicamente a parte de origem nem a parte ou o recurso de destino de forma alguma.
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)
- Origem:
- PackagePart.cs
- Origem:
- PackagePart.cs
- Origem:
- PackagePart.cs
Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo 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 este PackagePart para o PackagePart de destino ou recurso externo.
Exceções
targetUri ou relationshipType é null.
O parâmetro targetMode não é um valor de enumeração TargetMode válido.
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 parcial pode ser uma das duas formas.
Entre uma origem PackagePart e um destino PackagePart dentro do Package.
Entre uma origem PackagePart e um recurso de destino fora do pacote.
Em uma relação parcial, 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 ou o recurso de destino de forma alguma.
O CreateRelationship método não altera fisicamente a parte de origem nem a parte ou o recurso de destino de forma alguma.
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 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 os URIs de nível relationshipType de parte definidos para documentos que estão em conformidade com a Especificação de Papel XML Aberta (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)
- Origem:
- PackagePart.cs
- Origem:
- PackagePart.cs
- Origem:
- PackagePart.cs
Cria uma relação de nível de parte entre esta PackagePart para uma PackagePart de destino ou recurso externo 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);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 este PackagePart para o PackagePart de destino ou recurso externo.
Exceções
targetUri ou relationshipType é null.
O parâmetro targetMode não é um valor de enumeração TargetMode válido.
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).
id não é um identificador XML válido.
- ou -
Já existe uma parte com o id 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 parcial pode ser uma das duas formas.
Entre uma origem PackagePart e um destino PackagePart dentro do Package.
Entre uma origem PackagePart e um recurso de destino fora do pacote.
Em uma relação parcial, 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 ou o recurso de destino 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 na especificação XML Schema Part 2: Datatypes (consulte https://www.w3.org/TR/xmlschema-2/#ID).
O CreateRelationship método não altera fisicamente a parte de origem nem a parte ou o recurso de destino de forma alguma.
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 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 os URIs de nível relationshipType de parte definidos para documentos que estão em conformidade com a Especificação de Papel XML Aberta (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
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de