IOpcRelationship-Schnittstelle (msopc.h)

Artikel
02/29/2024

Stellt eine Beziehung dar, bei der es sich um eine Verbindung zwischen einer Quelle handelt, die ein Teil oder das Paket ist, und einem Ziel. Das Ziel der Beziehung kann ein Teil oder eine externe Ressource sein.

Vererbung

Die IOpcRelationship-Schnittstelle erbt von der IUnknown-Schnittstelle . IOpcRelationship verfügt auch über folgende Arten von Membern:

Methoden

Die IOpcRelationship-Schnittstelle verfügt über diese Methoden.


IOpcRelationship::GetId Ruft den eindeutigen Bezeichner der Beziehung ab.
IOpcRelationship::GetRelationshipType Ruft den Beziehungstyp ab.
IOpcRelationship::GetSourceUri Ruft den URI der Beziehungsquelle ab.
IOpcRelationship::GetTargetMode Ruft einen Wert ab, der beschreibt, ob das Ziel der Beziehung intern oder extern für das Paket ist.
IOpcRelationship::GetTargetUri Ruft den URI des Beziehungsziels ab.

Hinweise

Um ein Beziehungsobjekt zum Darstellen einer Beziehung zu erstellen, rufen Sie die IOpcRelationshipSet::CreateRelationship-Methode auf. Um einen Zeiger auf die Schnittstelle eines Beziehungsobjekts abzurufen, das eine vorhandene Beziehung darstellt, rufen Sie die IOpcRelationshipSet::GetRelationship - oder IOpcRelationshipEnumerator::GetCurrent-Methode auf.

Beispielbeziehungsmarkup für eine Beziehung, die auf ein Teil abzielt:

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

Die Verwendung des Beziehungstyps (Type-Attribut des Relationship-Elements ) ist die endgültige Möglichkeit, ein Teil in einem Paket zu finden. Weitere Informationen dazu, warum der Beziehungstyp verwendet wird, finden Sie in der Teileübersicht. Ein Beispiel für die Verwendung des Beziehungstyps zum Suchen eines Teils finden Sie unter Suchen des Kerneigenschaftenparts.

Gültige Bezeichner für Beziehungen entsprechen den Einschränkungen für xsd:ID, die in Abschnitt 3.3.8 ID der W3C-Empfehlung, XML Schema Part 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID) dokumentiert sind.

IOpcRelationship-Schnittstellenmethoden bieten Zugriff auf Beziehungseigenschaften für eine Beziehung (die durch ein Beziehungsobjekt dargestellt wird). Die Methoden, zugeordneten Eigenschaften und Beschreibungen sind in der folgenden Tabelle aufgeführt.

Methode	Eigenschaft	BESCHREIBUNG
Getid	Beziehungsbezeichner	Der eindeutige, beliebige Bezeichner einer Beziehung, die lokal für das Paket ist.
GetRelationshipType	Beziehungstyp	Der qualifizierte Name einer vom Paket-Designer definierten Beziehung.
GetSourceUri	Quell-URI	Der URI der Beziehungsquelle. Der Quell-URI kann der URI des Pakets oder eines Teils sein.
GetTargetMode	Zielmodus	Gibt an, ob das Ziel der Beziehung intern oder extern für das Paket ist.
GetTargetUri	Ziel-URI	Der URI des Beziehungsziels.

Weitere Informationen zu Beziehungen finden Sie unter Open Packaging Conventions Fundamentals und ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h