Interfaz IOpcRelationship (msopc.h)

Artículo
02/29/2024

Representa una relación, que es un vínculo entre un origen, que es una parte o el paquete, y un destino. El destino de la relación puede ser una parte o un recurso externo.

Herencia

La interfaz IOpcRelationship hereda de la interfaz IUnknown . IOpcRelationship también tiene estos tipos de miembros:

Métodos

La interfaz IOpcRelationship tiene estos métodos.


IOpcRelationship::GetId Obtiene el identificador único de la relación.
IOpcRelationship::GetRelationshipType Obtiene el tipo de relación.
IOpcRelationship::GetSourceUri Obtiene el URI del origen de la relación.
IOpcRelationship::GetTargetMode Obtiene un valor que describe si el destino de la relación es interno o externo al paquete.
IOpcRelationship::GetTargetUri Obtiene el URI del destino de la relación.

Comentarios

Para crear un objeto de relación para representar una relación, llame al método IOpcRelationshipSet::CreateRelationship . Para obtener un puntero a la interfaz de un objeto de relación que representa una relación existente, llame al método IOpcRelationshipSet::GetRelationship o IOpcRelationshipEnumerator::GetCurrent .

Marcado de relación de ejemplo para una relación destinada a una parte:

<Relationship Id="rId1"
    Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument"
    Target="word/document.xml" />

El uso del tipo de relación (atributo Type del elemento Relationship ) es la forma definitiva de buscar un elemento en un paquete. Para obtener más información sobre por qué se usa el tipo de relación, vea Información general de elementos. Para obtener un ejemplo de cómo usar el tipo de relación para buscar un elemento, vea Buscar el elemento de propiedades principales.

Los identificadores válidos para las relaciones se ajustan a las restricciones de xsd:ID, que se documentan en la sección 3.3.8 del identificador de la recomendación W3C, esquema XML Parte 2: Tipos de datos segunda edición (http://www.w3.org/TR/xmlschema-2/#ID).

Los métodos de interfaz IOpcRelationship proporcionan acceso a las propiedades de relación de una relación (que se representa mediante un objeto de relación). Los métodos, las propiedades y descripciones asociadas se enumeran en la tabla siguiente.

Método	Propiedad	Descripción
GetId	Identificador de relación	Identificador único arbitrario de una relación que es local para el paquete.
GetRelationshipType	Tipo de relación	Nombre completo de una relación definida por el diseñador de paquetes.
GetSourceUri	URI de origen	URI del origen de la relación. El URI de origen puede ser el URI del paquete o de una parte.
GetTargetMode	Modo de destino	Indica si el destino de la relación es interno o externo al paquete.
GetTargetUri	URI de destino	URI del destino de la relación.

Para obtener más información sobre las relaciones, vea Los aspectos básicos de las convenciones de empaquetado abierto y ecma-376 OpenXML, 1ª edición, parte 2: convenciones de empaquetado abierto (OPC).

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte el Introducción con packaging API.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h