PackagePart.CreateRelationship Método

Definición

Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

Sobrecargas

CreateRelationship(Uri, TargetMode, String)

Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

CreateRelationship(Uri, TargetMode, String, String)

Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

Comentarios

Una relación de nivel de elemento define una asociación entre esta parte y una parte o recurso de destino.A part-level relationship defines an association between this part and a target part or resource. Una relación de nivel de elemento puede ser una de dos formas.A part-level relationship can be one of two forms.

En una relación de elementos, la parte de origen se considera el "propietario" de la relación.In a part-relationship the source part is considered the "owner" of the relationship. Cuando se elimina la parte de origen, también se eliminan todas las relaciones propiedad del elemento.When the source part is deleted, all the relationships owned by the part are also deleted. El proceso de creación o eliminación de la relación no modifica físicamente la parte o el recurso de destino de ninguna manera.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

El método CreateRelationship no cambia físicamente la parte de origen ni la parte o el recurso de destino de ninguna manera.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

El destino de una relación no puede ser otra relación.The target of a relationship cannot be another relationship.

Para obtener más información acerca de las relaciones de paquete, consulte la sección 1,3 de la especificación de convenciones de empaquetado abierto (OPC) disponible para su descarga en https://go.microsoft.com/fwlink/?LinkID=71255.For more information about package relationships see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

Para obtener más información acerca de los documentos XPS, consulte Open XML Paper Specification (XPS) disponible para su descarga en https://go.microsoft.com/fwlink/?LinkID=67000.For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at https://go.microsoft.com/fwlink/?LinkID=67000.

CreateRelationship(Uri, TargetMode, String)

Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

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

Parámetros

targetUri
Uri

URI del elemento de destino.The URI of the target part.

targetMode
TargetMode

Uno de los valores de enumeración de .One of the enumeration values. Por ejemplo, Internal si el elemento de destino está en Package; o External si el destino es un recurso externo respecto a Package.For example, Internal if the target part is inside the Package; or External if the target is a resource outside the Package.

relationshipType
String

Rol de la relación.The role of the relationship.

Devoluciones

La relación de nivel de elemento entre PackagePart y PackagePart de destino o recurso externo.The part-level relationship between this PackagePart to the target PackagePart or external resource.

Excepciones

Se ha eliminado el elemento.The part has been deleted.

O bien,-or- La propiedad Package no está abierta (se ha llamado a Dispose(Boolean) o Close()).The Package is not open (Dispose(Boolean) or Close() has been called).

targetUri o relationshipType es null.targetUri or relationshipType is null.

El parámetro targetMode no es un valor válido de la enumeración TargetMode.The targetMode parameter is not a valid TargetMode enumeration value.

El elemento identificado por el targetUri es una relación (el destino de una relación no puede ser otra relación).The part identified by the targetUri is a relationship (the target of a relationship cannot be another relationship).

O bien,-or- targetMode se especifica como Internal, pero targetUri es un URI externo absoluto.targetMode is specified as Internal but targetUri is an absolute external URI.

El paquete es de sólo lectura; es decir, no se pueden agregar relaciones nuevas.The package is read-only (a new relationship cannot be added).

Comentarios

Una relación de nivel de elemento define una asociación entre esta parte y una parte o recurso de destino.A part-level relationship defines an association between this part and a target part or resource. Una relación de nivel de elemento puede ser una de dos formas.A part-level relationship can be one of two forms.

En una relación de elementos, la parte de origen se considera el "propietario" de la relación.In a part-relationship the source part is considered the "owner" of the relationship. Cuando se elimina la parte de origen, también se eliminan todas las relaciones propiedad del elemento.When the source part is deleted, all the relationships owned by the part are also deleted. El proceso de creación o eliminación de la relación no modifica físicamente la parte o el recurso de destino de ninguna manera.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

El método CreateRelationship no cambia físicamente la parte de origen ni la parte o el recurso de destino de ninguna manera.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

El destino de una relación no puede ser otra relación.The target of a relationship cannot be another relationship.

Si targetMode se especifica como Internal, targetUri debe ser un URI relativo formado de acuerdo con la especificación de Sintaxis genérica del identificador uniforme de recursos (URI) de RFC 3986 .If targetMode is specified as Internal, targetUri must be a relative URI that is formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. 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.The internal relative URI can be either an absolute path that starts with a forward slash ("/") character such as "/page1.xaml" or "/images/picture4.jpg", or a relative path such as "../imagespicture1.jpg" that resolves against the package root ("/") as the base URI.

Si targetMode se especifica como External, targetUri puede ser un URI absoluto o relativo formado de acuerdo con la especificación de Sintaxis genérica del identificador uniforme de recursos (URI) de RFC 3986 .If targetMode is specified as External, targetUri can be either an absolute or relative URI formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. "https://www.microsoft.com/page2.xml" es un ejemplo de un URI absoluto que hace referencia a un recurso de destino externo "página2. xml"."https://www.microsoft.com/page2.xml" is an example of an absolute URI that references an external target resource "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."images/picture1.jpg" is an example of a relative URI that also references an external target resource "1.jpg" but which resolves against the URI of the package itself.

relationshipType debe ser un URI formado según la especificación de Sintaxis genérica del identificador uniforme de recursos (URI) de RFC 3986 .relationshipType must be a URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. Los distintos tipos de paquetes pueden definir diferentes tipos de relación de nivel de elemento.Different package types can define different part-level relationship types. En la tabla siguiente se muestran los URI de relationshipType de nivel de parte definidos para los documentos que se ajustan a Open XML Paper Specification (XPS).The following table shows the part-level relationshipType URIs defined for documents that conform to the Open XML Paper Specification (XPS).

Relación de nivel de elemento de documento XPSXPS Document Part-Level Relationship URI del tipo de relaciónRelationship Type URI
Definiciones de firmas digitalesDigital Signature Definitions http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControlDiscardControl http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructureDocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicketPrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
Recurso necesarioRequired Resource http://schemas.microsoft.com/xps/2005/06/required-resource
Fuente restringidaRestricted Font http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPartStartPart http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragmentsStoryFragments http://schemas.microsoft.com/xps/2005/06/storyfragments

Para obtener más información acerca de las relaciones de paquete, consulte la sección 1,3 de la especificación de convenciones de empaquetado abierto (OPC) disponible para su descarga en https://go.microsoft.com/fwlink/?LinkID=71255.For more information about package relationships see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

Para obtener más información acerca de los documentos XPS, consulte Open XML Paper Specification (XPS) disponible para su descarga en https://go.microsoft.com/fwlink/?LinkID=67000.For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at https://go.microsoft.com/fwlink/?LinkID=67000.

Consulte también:

CreateRelationship(Uri, TargetMode, String, String)

Crea una relación de nivel de elemento entre este objeto PackagePart y un objeto PackagePart de destino especificado o un recurso externo.Creates a part-level relationship between this PackagePart to a specified target PackagePart or external resource.

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

Parámetros

targetUri
Uri

URI del elemento de destino.The URI of the target part.

targetMode
TargetMode

Uno de los valores de enumeración de .One of the enumeration values. Por ejemplo, Internal si el elemento de destino está en Package; o External si el destino es un recurso externo respecto a Package.For example, Internal if the target part is inside the Package; or External if the target is a resource outside the Package.

relationshipType
String

Rol de la relación.The role of the relationship.

id
String

Identificador único de la relación.A unique ID for the relationship.

Devoluciones

La relación de nivel de elemento entre PackagePart y PackagePart de destino o recurso externo.The part-level relationship between this PackagePart to the target PackagePart or external resource.

Excepciones

Se ha eliminado el elemento.The part has been deleted.

O bien,-or- La propiedad Package no está abierta (se ha llamado a Dispose(Boolean) o Close()).The Package is not open (Dispose(Boolean) or Close() has been called).

targetUri o relationshipType es null.targetUri or relationshipType is null.

El parámetro targetMode no es un valor válido de la enumeración TargetMode.The targetMode parameter is not a valid TargetMode enumeration value.

El elemento identificado por el targetUri es una relación (el destino de una relación no puede ser otra relación).The part identified by the targetUri is a relationship (the target of a relationship cannot be another relationship).

O bien,-or- targetMode se especifica como Internal, pero targetUri es un URI externo absoluto.targetMode is specified as Internal but targetUri is an absolute external URI.

El paquete es de sólo lectura; es decir, no se pueden agregar relaciones nuevas.The package is read-only (a new relationship cannot be added).

id no es un identificador XML válido.id is not a valid XML identifier.

O bien,-or- Ya existe un elemento con el id especificado.A part with the specified id already exists.

Comentarios

Una relación de nivel de elemento define una asociación entre esta parte y una parte o recurso de destino.A part-level relationship defines an association between this part and a target part or resource. Una relación de nivel de elemento puede ser una de dos formas.A part-level relationship can be one of two forms.

En una relación de elementos, la parte de origen se considera el "propietario" de la relación.In a part-relationship the source part is considered the "owner" of the relationship. Cuando se elimina la parte de origen, también se eliminan todas las relaciones propiedad del elemento.When the source part is deleted, all the relationships owned by the part are also deleted. El proceso de creación o eliminación de la relación no modifica físicamente la parte o el recurso de destino de ninguna manera.The process of creating or deleting the relationship does not physically alter the target part or resource in any way.

id debe ser un identificador XML válido.id must be a valid XML identifier. El tipo de id es xsd: ID y debe seguir las convenciones de nomenclatura prescritas en la especificación de XML Schema Part 2: Datatypes (vea https://www.w3.org/TR/xmlschema-2/#ID).The id type is xsd:ID and must follow the naming conventions prescribed in the XML Schema Part 2: Datatypes specification (see https://www.w3.org/TR/xmlschema-2/#ID).

El método CreateRelationship no cambia físicamente la parte de origen ni la parte o el recurso de destino de ninguna manera.The CreateRelationship method does not physically change either the source part, or the target part or resource in any way.

El destino de una relación no puede ser otra relación.The target of a relationship cannot be another relationship.

Si targetMode se especifica como Internal, targetUri debe ser un URI relativo formado de acuerdo con la especificación de Sintaxis genérica del identificador uniforme de recursos (URI) de RFC 3986 .If targetMode is specified as Internal, targetUri must be a relative URI that is formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. 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.The internal relative URI can be either an absolute path that starts with a forward slash ("/") character such as "/page1.xaml" or "/images/picture4.jpg", or a relative path such as "../imagespicture1.jpg" that resolves against the package root ("/") as the base URI.

Si targetMode se especifica como External, targetUri puede ser un URI absoluto o relativo formado de acuerdo con la especificación de Sintaxis genérica del identificador uniforme de recursos (URI) de RFC 3986 .If targetMode is specified as External, targetUri can be either an absolute or relative URI formed in accordance with the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. "https://www.microsoft.com/page2.xml" es un ejemplo de un URI absoluto que hace referencia a un recurso de destino externo "página2. xml"."https://www.microsoft.com/page2.xml" is an example of an absolute URI that references an external target resource "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."images/picture1.jpg" is an example of a relative URI that also references an external target resource "1.jpg" but which resolves against the URI of the package itself.

relationshipType debe ser un URI formado según la especificación de Sintaxis genérica del identificador uniforme de recursos (URI) de RFC 3986 .relationshipType must be a URI that is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. Los distintos tipos de paquetes pueden definir diferentes tipos de relación de nivel de elemento.Different package types can define different part-level relationship types. En la tabla siguiente se muestran los URI de relationshipType de nivel de parte definidos para los documentos que se ajustan a Open XML Paper Specification (XPS).The following table shows the part-level relationshipType URIs defined for documents that conform to the Open XML Paper Specification (XPS).

Relación de nivel de elemento de documento XPSXPS Document Part-Level Relationship URI del tipo de relaciónRelationship Type URI
Definiciones de firmas digitalesDigital Signature Definitions http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControlDiscardControl http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructureDocumentStructure http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicketPrintTicket http://schemas.microsoft.com/xps/2005/06/printticket
Recurso necesarioRequired Resource http://schemas.microsoft.com/xps/2005/06/required-resource
Fuente restringidaRestricted Font http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPartStartPart http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragmentsStoryFragments http://schemas.microsoft.com/xps/2005/06/storyfragments

Para obtener más información acerca de las relaciones de paquete, consulte la sección 1,3 de la especificación de convenciones de empaquetado abierto (OPC) disponible para su descarga en https://go.microsoft.com/fwlink/?LinkID=71255.For more information about package relationships see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at https://go.microsoft.com/fwlink/?LinkID=71255.

Para obtener más información acerca de los documentos XPS, consulte Open XML Paper Specification (XPS) disponible para su descarga en https://go.microsoft.com/fwlink/?LinkID=67000.For more information about XPS documents see the Open XML Paper Specification (XPS) available for download at https://go.microsoft.com/fwlink/?LinkID=67000.

Consulte también:

Se aplica a