PackagePart.CreateRelationship Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea una relación de nivel de parte entre esta PackagePart a un recurso externo o PackagePart de destino especificado.
CreateRelationship(Uri, TargetMode, String) |
Crea una relación de nivel de parte entre esta PackagePart a un recurso externo o PackagePart de destino especificado. |
CreateRelationship(Uri, TargetMode, String, String) |
Crea una relación de nivel de parte entre esta PackagePart a un recurso externo o PackagePart de destino especificado. |
Una relación de nivel de parte define una asociación entre esta parte y un elemento o recurso de destino. Una relación de nivel de parte puede ser una de estas dos formas.
Entre un PackagePart de origen a un PackagePart de destino dentro del Package.
Entre un origen PackagePart a un recurso de destino fuera del paquete.
En una relación de parte, el elemento de origen se considera el "propietario" de la relación. Cuando se elimina el elemento de origen, también se eliminan todas las relaciones que pertenecen a la parte. El proceso de creación o eliminación de la relación no modifica físicamente la parte de destino ni el recurso de ninguna manera.
El método CreateRelationship no cambia físicamente la parte de origen ni el elemento de destino ni el recurso de ninguna manera.
El destino de una relación no puede ser otra relación.
Para obtener más información sobre las relaciones de paquetes, consulte la sección 1.3 de la open Packaging Conventions (OPC) especificación disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Para obtener más información sobre los documentos XPS, consulte la especificación de papel Open XML (XPS) disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
Crea una relación de nivel de parte entre esta PackagePart a un recurso externo o PackagePart de destino 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.PackageRelationship
Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationship
Parámetros
- targetUri
- Uri
Identificador URI de la parte de destino.
- targetMode
- TargetMode
Uno de los valores de enumeración. Por ejemplo, Internal si la parte de destino está dentro del Package; o External si el destino es un recurso fuera del Package.
- relationshipType
- String
Rol de la relación.
Devoluciones
Relación de nivel de parte entre este PackagePart con el PackagePart de destino o el recurso externo.
Excepciones
Se ha eliminado la parte.
-o-
El Package no está abierto ( se ha llamado aDispose(Boolean) o Close()).
targetUri
o relationshipType
es null
.
El parámetro targetMode
no es un valor de enumeración TargetMode válido.
La parte identificada por el targetUri
es una relación (el destino de una relación no puede ser otra relación).
-o-
targetMode
se especifica como Internal, pero targetUri
es un URI externo absoluto.
El paquete es de solo lectura (no se puede agregar una nueva relación).
Comentarios
Una relación de nivel de parte define una asociación entre esta parte y un elemento o recurso de destino. Una relación de nivel de parte puede ser una de estas dos formas.
Entre un PackagePart de origen a un PackagePart de destino dentro del Package.
Entre un origen PackagePart a un recurso de destino fuera del paquete.
En una relación de parte, el elemento de origen se considera el "propietario" de la relación. Cuando se elimina el elemento de origen, también se eliminan todas las relaciones que pertenecen a la parte. El proceso de creación o eliminación de la relación no modifica físicamente la parte de destino ni el recurso de ninguna manera.
El método CreateRelationship no cambia físicamente la parte de origen ni el elemento de destino ni el recurso de ninguna manera.
El destino de una relación no puede ser otra relación.
Si
Si "https://www.microsoft.com/page2.xml"
es un ejemplo de un URI absoluto que hace referencia a un recurso de destino externo "page2.xml". "images/picture1.jpg" es un ejemplo de un URI relativo que también hace referencia a un recurso de destino externo "1.jpg", pero que se resuelve en el URI del propio paquete.
relationshipType
definidos para los documentos que se ajustan a la especificación de papel Open XML (XPS).
Relación de Part-Level de documentos XPS | URI de tipo de relación |
---|---|
Definiciones de firma 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 requerido | http://schemas.microsoft.com/xps/2005/06/required-resource |
Fuente restringida | 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 obtener más información sobre las relaciones de paquetes, consulte la sección 1.3 de la open Packaging Conventions (OPC) especificación disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Para obtener más información sobre los documentos XPS, consulte la
Consulte también
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- especificación de convenciones de empaquetado abierto
Se aplica a
.NET 9 (package-provided) y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided) |
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
- Source:
- PackagePart.cs
Crea una relación de nivel de parte entre esta PackagePart a un recurso externo o PackagePart de destino 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.PackageRelationship
Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationship
Parámetros
- targetUri
- Uri
Identificador URI de la parte de destino.
- targetMode
- TargetMode
Uno de los valores de enumeración. Por ejemplo, Internal si la parte de destino está dentro del Package; o External si el destino es un recurso fuera del Package.
- relationshipType
- String
Rol de la relación.
- id
- String
Un identificador único para la relación.
Devoluciones
Relación de nivel de parte entre este PackagePart con el PackagePart de destino o el recurso externo.
Excepciones
Se ha eliminado la parte.
-o-
El Package no está abierto ( se ha llamado aDispose(Boolean) o Close()).
targetUri
o relationshipType
es null
.
El parámetro targetMode
no es un valor de enumeración TargetMode válido.
La parte identificada por el targetUri
es una relación (el destino de una relación no puede ser otra relación).
-o-
targetMode
se especifica como Internal, pero targetUri
es un URI externo absoluto.
El paquete es de solo lectura (no se puede agregar una nueva relación).
Comentarios
Una relación de nivel de parte define una asociación entre esta parte y un elemento o recurso de destino. Una relación de nivel de parte puede ser una de estas dos formas.
Entre un PackagePart de origen a un PackagePart de destino dentro del Package.
Entre un origen PackagePart a un recurso de destino fuera del paquete.
En una relación de parte, el elemento de origen se considera el "propietario" de la relación. Cuando se elimina el elemento de origen, también se eliminan todas las relaciones que pertenecen a la parte. El proceso de creación o eliminación de la relación no modifica físicamente la parte de destino ni el recurso de ninguna manera.
id
debe ser un identificador XML válido. El tipo id
es xsd:ID y debe seguir las convenciones de nomenclatura prescritas en la parte 2 del esquema XML de : Tipos de datos especificación (vea https://www.w3.org/TR/xmlschema-2/#ID).
El método CreateRelationship no cambia físicamente la parte de origen ni el elemento de destino ni el recurso de ninguna manera.
El destino de una relación no puede ser otra relación.
Si
Si
relationshipType
definidos para los documentos que se ajustan a la especificación de papel Open XML (XPS).
Relación de Part-Level de documentos XPS | URI de tipo de relación |
---|---|
Definiciones de firma 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 requerido | http://schemas.microsoft.com/xps/2005/06/required-resource |
Fuente restringida | 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 obtener más información sobre las relaciones de paquetes, consulte la sección 1.3 de la open Packaging Conventions (OPC) especificación disponible para su descarga en https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Para obtener más información sobre los documentos XPS, consulte el
Consulte también
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- especificación de convenciones de empaquetado abierto
Se aplica a
.NET 9 (package-provided) y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided) |
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: