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 esse PackagePart a um PackagePart de destino ou recurso externo especificado.
Sobrecargas
| CreateRelationship(Uri, TargetMode, String) |
Cria uma relação de nível de parte entre esse PackagePart a um PackagePart de destino ou recurso externo especificado. |
| CreateRelationship(Uri, TargetMode, String, String) |
Cria uma relação de nível de parte entre esse PackagePart a um 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 de parte pode ser uma das duas formas.
Entre um PackagePart de origem a um PackagePart de destino dentro do Package.
Entre um PackagePart de origem 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 método CreateRelationship não altera fisicamente a parte de origem ou a parte de destino ou o recurso 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 de
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
- Origem:
- PackagePart.cs
Cria uma relação de nível de parte entre esse PackagePart a um 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 essa PackagePart ao PackagePart de destino ou ao recurso externo.
Exceções
targetUri ou relationshipType é null.
O parâmetro targetMode não é um valor de enumeração de 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 de parte pode ser uma das duas formas.
Entre um PackagePart de origem a um PackagePart de destino dentro do Package.
Entre um PackagePart de origem 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 método CreateRelationship não altera fisicamente a parte de origem ou a parte de destino ou o recurso 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 que seja formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier) do 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 "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.
| 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 de
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)
- de 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
- Origem:
- PackagePart.cs
Cria uma relação de nível de parte entre esse PackagePart a um 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 essa PackagePart ao PackagePart de destino ou ao recurso externo.
Exceções
targetUri ou relationshipType é null.
O parâmetro targetMode não é um valor de enumeração de 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 de parte pode ser uma das duas formas.
Entre um PackagePart de origem a um PackagePart de destino dentro do Package.
Entre um PackagePart de origem 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 tipo id é xsd:ID e deve seguir as convenções de nomenclatura prescritas no esquema XML parte 2: especificação de de tipos de dados (consulte https://www.w3.org/TR/xmlschema-2/#ID).
O método CreateRelationship não altera fisicamente a parte de origem ou a parte de destino ou o recurso 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 que seja formado de acordo com a especificação de sintaxe genérica do URI (Uniform Resource Identifier) do 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
| 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 de
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)
- de 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