PackagePart.CreateRelationship Método

Definición

Espacio de nombres:

System.IO.Packaging

Ensamblado:

System.IO.Packaging.dll

Crea una relación de nivel de parte entre esta PackagePart a un recurso externo o PackagePart de destino especificado.

Sobrecargas

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.

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.

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/.

CreateRelationship(Uri, TargetMode, String)

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

PackageRelationship

Relación de nivel de parte entre este PackagePart con el PackagePart de destino o el recurso externo.

Excepciones

InvalidOperationException

Se ha eliminado la parte.

-o-

El Package no está abierto ( se ha llamado aDispose(Boolean) o Close()).

ArgumentNullException

targetUri o relationshipType es null.

ArgumentOutOfRangeException

El parámetro targetMode no es un valor de enumeración TargetMode válido.

ArgumentException

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.

IOException

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 se especifica como , debe ser un URI relativo formado de acuerdo con la especificación de sintaxis genérica de RFC 3986identificador uniforme de recursos (URI). El URI relativo interno puede ser una ruta de acceso absoluta que comienza con un carácter de barra diagonal ("/") como "/page1.xaml" o "/images/picture4.jpg" o una ruta de acceso relativa como ".. /imagespicture1.jpg" que se resuelve en la raíz del paquete ("/") como el URI base.

Si se especifica como , puede ser un URI absoluto o relativo formado de acuerdo con la especificación de sintaxis genérica de RFC 3986identificador uniforme de recursos (URI). "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.

debe ser un URI formado según la especificación de sintaxis genérica (URI) de RFC 3986 RFC 3986. Los distintos tipos de paquete pueden definir diferentes tipos de relación de nivel de parte. En la tabla siguiente se muestran los URI de nivel de parte 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 Especificación de papel Open XML (XPS) disponible para su descarga en .

Consulte también

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• especificación de convenciones de empaquetado abierto

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.

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.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

PackageRelationship

Relación de nivel de parte entre este PackagePart con el PackagePart de destino o el recurso externo.

Excepciones

InvalidOperationException

Se ha eliminado la parte.

-o-

El Package no está abierto ( se ha llamado aDispose(Boolean) o Close()).

ArgumentNullException

targetUri o relationshipType es null.

ArgumentOutOfRangeException

El parámetro targetMode no es un valor de enumeración TargetMode válido.

ArgumentException

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.

IOException

El paquete es de solo lectura (no se puede agregar una nueva relación).

XmlException

id no es un identificador XML válido.

-o-

Ya existe una parte con el id especificado.

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 se especifica como , debe ser un URI relativo formado de acuerdo con la especificación de sintaxis genérica de RFC 3986identificador uniforme de recursos (URI). El URI relativo interno puede ser una ruta de acceso absoluta que comienza con un carácter de barra diagonal ("/") como "/page1.xaml" o "/images/picture4.jpg" o una ruta de acceso relativa como ".. /imagespicture1.jpg" que se resuelve en la raíz del paquete ("/") como el URI base.

Si se especifica como , puede ser un URI absoluto o relativo formado de acuerdo con la especificación de sintaxis genérica de RFC 3986identificador uniforme de recursos (URI). "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.

debe ser un URI formado según la especificación de sintaxis genérica (URI) de RFC 3986 RFC 3986. Los distintos tipos de paquete pueden definir diferentes tipos de relación de nivel de parte. En la tabla siguiente se muestran los URI de nivel de parte 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 Open XML Paper Specification (XPS) disponible para su descarga en .

Consulte también

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• especificación de convenciones de empaquetado abierto