Antarmuka IOpcRelationship (msopc.h)

Artikel
10/26/2023

Mewakili hubungan, yang merupakan tautan antara sumber, yang merupakan bagian atau paket, dan target. Target hubungan dapat menjadi bagian atau sumber daya eksternal.

Warisan

Antarmuka IOpcRelationship mewarisi dari antarmuka IUnknown . IOpcRelationship juga memiliki jenis anggota ini:

Metode

Antarmuka IOpcRelationship memiliki metode ini.


IOpcRelationship::GetId Mendapatkan pengidentifikasi unik hubungan.
IOpcRelationship::GetRelationshipType Mendapatkan jenis hubungan.
IOpcRelationship::GetSourceUri Mendapatkan URI sumber hubungan.
IOpcRelationship::GetTargetMode Mendapatkan nilai yang menjelaskan apakah target hubungan bersifat internal atau eksternal untuk paket.
IOpcRelationship::GetTargetUri Mendapatkan URI target hubungan.

Keterangan

Untuk membuat objek hubungan untuk mewakili hubungan, panggil metode IOpcRelationshipSet::CreateRelationship . Untuk mendapatkan penunjuk ke antarmuka objek hubungan yang mewakili hubungan yang ada, panggil metode IOpcRelationshipSet::GetRelationship atau IOpcRelationshipEnumerator::GetCurrent .

Contoh markup hubungan untuk hubungan yang menargetkan bagian:

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

Menggunakan jenis hubungan (Atribut jenis elemen Hubungan ) adalah cara pasti menemukan bagian dalam paket. Untuk informasi selengkapnya tentang mengapa jenis hubungan digunakan, lihat Gambaran Umum Bagian. Untuk contoh penggunaan jenis hubungan untuk menemukan bagian, lihat Menemukan Bagian Properti Inti.

Pengidentifikasi yang valid untuk hubungan sesuai dengan batasan untuk xsd:ID, yang didokumentasikan dalam bagian 3.3.8 ID dari Rekomendasi W3C, Skema XML Bagian 2: Datatypes Edisi Kedua (http://www.w3.org/TR/xmlschema-2/#ID).

Metode antarmuka IOpcRelationship menyediakan akses ke properti hubungan untuk hubungan (yang diwakili oleh objek hubungan). Metode, properti dan deskripsi terkait tercantum dalam tabel berikut.

Metode	Properti	Deskripsi
GetId	Pengidentifikasi hubungan	Pengidentifikasi unik dan arbitrer dari hubungan yang lokal dengan paket.
GetRelationshipType	Jenis hubungan	Nama yang memenuhi syarat dari hubungan yang ditentukan oleh perancang paket.
GetSourceUri	URI Sumber	URI sumber hubungan. URI sumber dapat menjadi URI paket atau bagian.
GetTargetMode	Mode target	Menunjukkan apakah target hubungan bersifat internal atau eksternal untuk paket.
GetTargetUri	Target URI	URI target hubungan.

Untuk informasi selengkapnya tentang hubungan, lihat Dasar-Dasar Konvensi Kemasan Terbuka dan ECMA-376 OpenXML, Edisi Ke-1, Bagian 2: Konvensi Kemasan Terbuka (OPC).

Keamanan Thread

Objek pengemasan tidak aman untuk rangkaian.

Untuk informasi selengkapnya, lihat Memulai API Kemasan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	msopc.h