IOpcRelationship-Schnittstelle (msopc.h)

Stellt eine Beziehung dar, bei der es sich um eine Verknüpfung zwischen einer Quelle, einem Teil oder paket handelt, 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 die folgenden Typen von Mitgliedern:

Methodik

Die IOpcRelationship-Schnittstelle hat 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.

Bemerkungen

Rufen Sie zum Erstellen eines Beziehungsobjekts, das eine Beziehung darstellt, die IOpcRelationshipSet::CreateRelationship-Methode auf. Rufen Sie zum Abrufen eines Zeigers auf die Schnittstelle eines Beziehungsobjekts, das eine vorhandene Beziehung darstellt, das IOpcRelationshipSet::GetRelationship oder IOpcRelationshipEnumerator::GetCurrent-Methode auf.

Beispiel für Beziehungsmarkup für eine Beziehung, die auf einen Teil ausgerichtet ist:

<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, einen Teil in einem Paket zu finden. Weitere Informationen dazu, warum der Beziehungstyp verwendet wird, finden Sie in der Übersicht über Teile. Ein Beispiel für die Verwendung des Beziehungstyps zum Suchen eines Teils finden Sie unter Suchen des Kerneigenschaftenteils.

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-Schemateil 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 Eigentum Description
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 Quelle der Beziehung. 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 Ziels der Beziehung.
 

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

Threadsicherheit

Das Verpacken von Objekten ist nicht threadsicher.

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

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 7 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Fenster
Header msopc.h

Siehe auch

Kernverpackungsschnittstellen

ECMA-376 OpenXML

Externe Ressourcen

Suchen des Kerneigenschaftenteils

Erste Schritte mit der Verpackungs-API

IOpcRelationshipSet

OPC_URI_TARGET_MODE

Grundlagen der Open Packaging-Konventionen

Übersichten

Api-Referenz zum Packen

Packen von API-Beispielen

Referenz

Übersicht über Beziehungen