(msopc.h) IOpcRelationship 介面

發行項
03/05/2024

表示關聯性，這是來源之間的連結，也就是元件或封裝，以及目標。關聯性的目標可以是部分或外部資源。

繼承

IOpcRelationship 介面繼承自 IUnknown 介面。 IOpcRelationship 也有下列類型的成員：

方法

IOpcRelationship 介面具有這些方法。


IOpcRelationship：：GetId 取得關聯性的唯一標識碼。
IOpcRelationship：：GetRelationshipType 取得關聯性類型。
IOpcRelationship：：GetSourceUri 取得關聯性來源的 URI。
IOpcRelationship：：GetTargetMode 取得值，這個值描述關聯性的目標是否為封裝的內部或外部。
IOpcRelationship：：GetTargetUri 取得關聯性目標的 URI。

備註

若要建立關聯性對象來代表關聯性，請呼叫 IOpcRelationshipSet：：CreateRelationship 方法。若要取得代表現有關聯性之關聯性對象的介面指標，請呼叫 IOpcRelationshipSet：：GetRelationship 或 IOpcRelationshipEnumerator：：GetCurrent 方法。

以元件為目標之關聯性的範例關聯性標記：

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

使用關聯性類型 (Relationship 元素的 Type 屬性) 是尋找套件中元件的最終方式。如需為何使用關聯性類型的詳細資訊，請參閱元件概觀。如需使用關聯性類型尋找元件的範例，請參閱尋找核心屬性元件。

關聯性的有效標識碼符合 xsd：ID 的限制，這些限制記載於 W3C 建議的第 3.3.8 節標識碼、 XML 架構第 2 部分：數據類型第二版 (http://www.w3.org/TR/xmlschema-2/#ID) 。

IOpcRelationship 介面方法可為關聯性 (提供關聯性屬性的存取權，該關聯性屬性是由關聯性物件所表示) 。下表列出方法、相關聯的屬性和描述。

方法	屬性	Description
GetId	關聯性標識碼	封裝本機關聯性的唯一任意標識符。
GetRelationshipType	關聯性類型	封裝設計工具所定義之關聯性的限定名稱。
GetSourceUri	來源 URI	關聯性來源的 URI。來源 URI 可以是封裝或元件的 URI。
GetTargetMode	目標模式	指出關聯性的目標是封裝的內部或外部。
GetTargetUri	目標 URI	關聯性目標的 URI。

如需關聯性的詳細資訊，請參閱開放式封裝慣例基本概念和 ECMA-376 OpenXML，第 1 版，第 2 部分：開放式封裝慣例 (OPC) 。

執行緒安全性

封裝物件不是安全線程。

如需詳細資訊，請參閱使用封裝 API 使用者入門。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	msopc.h