Interfaccia IOpcRelationship (msopc.h)

Articolo
10/26/2023

Rappresenta una relazione, ovvero un collegamento tra un'origine, una parte o il pacchetto e una destinazione. La destinazione della relazione può essere una risorsa parte o esterna.

Ereditarietà

L'interfaccia IOpcRelationship eredita dall'interfaccia IUnknown . IOpcRelationship include anche questi tipi di membri:

Metodi

L'interfaccia IOpcRelationship include questi metodi.


IOpcRelationship::GetId Ottiene l'identificatore univoco della relazione.
IOpcRelationship::GetRelationshipType Ottiene il tipo di relazione.
IOpcRelationship::GetSourceUri Ottiene l'URI dell'origine della relazione.
IOpcRelationship::GetTargetMode Ottiene un valore che descrive se la destinazione della relazione è interna o esterna al pacchetto.
IOpcRelationship::GetTargetUri Ottiene l'URI della destinazione della relazione.

Commenti

Per creare un oggetto relazione per rappresentare una relazione, chiamare il metodo IOpcRelationshipSet::CreateRelationship . Per ottenere un puntatore all'interfaccia di un oggetto relazione che rappresenta una relazione esistente, chiamare il metodo IOpcRelationshipSet::GetRelationship o IOpcRelationshipEnumerator::GetCurrent .

Markup delle relazioni di esempio per una relazione destinata a una parte:

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

L'uso del tipo di relazione (attributo Type dell'elemento Relationship ) è il modo definitivo per trovare una parte in un pacchetto. Per altre informazioni sul motivo per cui viene usato il tipo di relazione, vedere Panoramica delle parti. Per un esempio di per usare il tipo di relazione per trovare una parte, vedere Ricerca della parte Proprietà di base.

Identificatori validi per le relazioni conformi alle restrizioni per xsd:ID, documentati nella sezione 3.3.8 ID della raccomandazione W3C, XML Schema Part 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID).

I metodi di interfaccia IOpcRelationship forniscono l'accesso alle proprietà della relazione per una relazione (rappresentata da un oggetto relazione). I metodi, le proprietà associate e le descrizioni sono elencati nella tabella seguente.

Metodo	Proprietà	Descrizione
GetId	Identificatore di relazione	Identificatore univoco arbitrario di una relazione locale al pacchetto.
GetRelationshipType	Tipo di relazione	Nome qualificato di una relazione definita dalla finestra di progettazione pacchetti.
GetSourceUri	URI di origine	URI dell'origine della relazione. L'URI di origine può essere l'URI del pacchetto o di una parte.
GetTargetMode	Modalità di destinazione	Indica se la destinazione della relazione è interna o esterna al pacchetto.
GetTargetUri	URI di destinazione	URI della destinazione della relazione.

Per altre informazioni sulle relazioni, vedere Open Packaging Conventions Fundamentals e ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

Thread safety

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h