Interface IOpcRelationship (msopc.h)

Article
10/26/2023

Représente une relation, qui est un lien entre une source, qui est une partie ou le package, et une cible. La cible de la relation peut être une partie ou une ressource externe.

Héritage

L’interface IOpcRelationship hérite de l’interface IUnknown. IOpcRelationship a également les types de membres suivants :

Méthodes

L’interface IOpcRelationship a ces méthodes.


IOpcRelationship ::GetId Obtient l’identificateur unique de la relation.
IOpcRelationship ::GetRelationshipType Obtient le type de relation.
IOpcRelationship ::GetSourceUri Obtient l’URI de la source de relation.
IOpcRelationship ::GetTargetMode Obtient une valeur qui indique si la cible de la relation est interne ou externe au package.
IOpcRelationship ::GetTargetUri Obtient l’URI de la cible de relation.

Remarques

Pour créer un objet de relation représentant une relation, appelez la méthode IOpcRelationshipSet ::CreateRelationship . Pour obtenir un pointeur vers l’interface d’un objet de relation qui représente une relation existante, appelez la méthode IOpcRelationshipSet ::GetRelationship ou IOpcRelationshipEnumerator ::GetCurrent .

Exemple de balisage de relation pour une relation qui cible une partie :

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

L’utilisation du type de relation (attribut Type de l’élément Relationship ) est la façon définitive de trouver une partie dans un package. Pour plus d’informations sur la raison pour laquelle le type de relation est utilisé, consultez Vue d’ensemble des composants. Pour obtenir un exemple d’utilisation du type de relation pour rechercher un composant, consultez Recherche du composant Propriétés principales.

Les identificateurs valides pour les relations sont conformes aux restrictions pour xsd :ID, qui sont documentées dans la section 3.3.8 ID de la recommandation W3C, schéma XML Partie 2 : Types de données Deuxième édition (http://www.w3.org/TR/xmlschema-2/#ID).

Les méthodes d’interface IOpcRelationship permettent d’accéder aux propriétés de relation d’une relation (qui est représentée par un objet de relation). Les méthodes, les propriétés associées et les descriptions sont répertoriées dans le tableau suivant.

Méthode	Propriété	Description
GetId	Identificateur de relation	Identificateur unique et arbitraire d’une relation locale au package.
GetRelationshipType	Type de relation	Nom qualifié d’une relation définie par le concepteur de package.
GetSourceUri	URI source	URI de la source de la relation. L’URI source peut être l’URI du package ou d’une partie.
GetTargetMode	Mode cible	Indique si la cible de la relation est interne ou externe au package.
GetTargetUri	URI cible	URI de la cible de la relation.

Pour plus d’informations sur les relations, consultez Open Packaging Conventions Fundamentals et ECMA-376 OpenXML, 1st Edition, Part 2 : Open Packaging Conventions (OPC) .

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API Packaging.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h