PackagePart.CreateRelationship Metode

Definisi

Ruang nama:

System.IO.Packaging

Rakitan:

System.IO.Packaging.dll

Membuat hubungan tingkat bagian antara PackagePart ini ke target tertentu PackagePart atau sumber daya eksternal.

Overload

CreateRelationship(Uri, TargetMode, String)	Membuat hubungan tingkat bagian antara PackagePart ini ke target tertentu PackagePart atau sumber daya eksternal.
CreateRelationship(Uri, TargetMode, String, String)	Membuat hubungan tingkat bagian antara PackagePart ini ke target tertentu PackagePart atau sumber daya eksternal.

Keterangan

Hubungan tingkat bagian mendefinisikan hubungan antara bagian ini dan bagian target atau sumber daya. Hubungan tingkat bagian bisa menjadi salah satu dari dua bentuk.

• Antara sumber PackagePart ke PackagePart target di dalam Package.

• Antara sumber PackagePart ke sumber daya target di luar paket.

Dalam hubungan sebagian bagian sumber dianggap sebagai "pemilik" hubungan. Ketika bagian sumber dihapus, semua hubungan yang dimiliki oleh bagian juga dihapus. Proses pembuatan atau penghapusan hubungan tidak secara fisik mengubah bagian target atau sumber daya dengan cara apa pun.

Metode CreateRelationship tidak secara fisik mengubah bagian sumber, atau bagian target atau sumber daya dengan cara apa pun.

Target hubungan tidak boleh hubungan lain.

Untuk informasi selengkapnya tentang hubungan paket, lihat bagian 1.3 dari spesifikasi Open Packaging Conventions (OPC) yang tersedia untuk diunduh di .

Untuk informasi selengkapnya tentang dokumen XPS, lihat Spesifikasi Kertas Open XML (XPS) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

CreateRelationship(Uri, TargetMode, String)

Membuat hubungan tingkat bagian antara PackagePart ini ke target tertentu PackagePart atau sumber daya eksternal.

public:
 System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType);

public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType);

member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string -> System.IO.Packaging.PackageRelationship

Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationship

Parameter

targetUri

Uri

URI bagian target.

targetMode

TargetMode

Salah satu nilai enumerasi. Misalnya, Internal jika bagian target berada di dalam Package; atau External jika target adalah sumber daya di luar Package.

relationshipType

String

Peran hubungan.

Mengembalikan

PackageRelationship

Hubungan tingkat bagian antara PackagePart ini dengan PackagePart target atau sumber daya eksternal.

Pengecualian

InvalidOperationException

Bagian telah dihapus.

-atau-

Package tidak terbuka (Dispose(Boolean) atau Close() telah dipanggil).

ArgumentNullException

targetUri atau relationshipTypenull.

ArgumentOutOfRangeException

Parameter targetMode bukan nilai enumerasi TargetMode yang valid.

ArgumentException

Bagian yang diidentifikasi oleh targetUri adalah hubungan (target hubungan tidak boleh hubungan lain).

-atau-

targetMode ditentukan sebagai Internal tetapi targetUri adalah URI eksternal absolut.

IOException

Paket bersifat baca-saja (hubungan baru tidak dapat ditambahkan).

Keterangan

Hubungan tingkat bagian mendefinisikan hubungan antara bagian ini dan bagian target atau sumber daya. Hubungan tingkat bagian bisa menjadi salah satu dari dua bentuk.

• Antara sumber PackagePart ke PackagePart target di dalam Package.

• Antara sumber PackagePart ke sumber daya target di luar paket.

Dalam hubungan sebagian bagian sumber dianggap sebagai "pemilik" hubungan. Ketika bagian sumber dihapus, semua hubungan yang dimiliki oleh bagian juga dihapus. Proses pembuatan atau penghapusan hubungan tidak secara fisik mengubah bagian target atau sumber daya dengan cara apa pun.

Metode CreateRelationship tidak secara fisik mengubah bagian sumber, atau bagian target atau sumber daya dengan cara apa pun.

Target hubungan tidak boleh hubungan lain.

Jika ditentukan sebagai , harus merupakan URI relatif yang dibentuk sesuai dengan spesifikasi SintaksIs Generik RFC 3986Uniform Resource Identifier (URI). URI relatif internal dapat berupa jalur absolut yang dimulai dengan karakter garis miring ("/") seperti "/page1.xaml" atau "/images/picture4.jpg", atau jalur relatif seperti ".. /imagespicture1.jpg" yang menyelesaikan terhadap akar paket ("/") sebagai URI dasar.

Jika ditentukan sebagai , dapat berupa URI absolut atau relatif yang terbentuk sesuai dengan spesifikasi RFC 3986Uniform Resource Identifier (URI). "https://www.microsoft.com/page2.xml" adalah contoh URI absolut yang mereferensikan sumber daya target eksternal "page2.xml". "images/picture1.jpg" adalah contoh URI relatif yang juga mereferensikan sumber daya target eksternal "1.jpg" tetapi yang menyelesaikan terhadap URI paket itu sendiri.

relationshipType harus berupa URI yang dibentuk sesuai dengan spesifikasi RFC 3986Uniform Resource Identifier (URI) Generic Syntax. Jenis paket yang berbeda dapat menentukan jenis hubungan tingkat bagian yang berbeda. Tabel berikut ini memperlihatkan URI relationshipType tingkat bagian yang ditentukan untuk dokumen yang sesuai dengan Open XML Paper Specification (XPS).

Hubungan Part-Level Dokumen XPS	Jenis Hubungan URI
Definisi Tanda Tangan Digital	http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControl	http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructure	http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicket	http://schemas.microsoft.com/xps/2005/06/printticket
Sumber Daya yang Diperlukan	http://schemas.microsoft.com/xps/2005/06/required-resource
Font Terbatas	http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPart	http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragments	http://schemas.microsoft.com/xps/2005/06/storyfragments

Untuk informasi selengkapnya tentang hubungan paket, lihat bagian 1.3 dari spesifikasi Open Packaging Conventions (OPC) yang tersedia untuk diunduh di .

Untuk informasi selengkapnya tentang dokumen XPS, lihat Open XML Paper Specification (XPS) yang tersedia untuk diunduh di .

Lihat juga

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Spesifikasi Konvensi Kemasan Terbuka

CreateRelationship(Uri, TargetMode, String, String)

Membuat hubungan tingkat bagian antara PackagePart ini ke target tertentu PackagePart atau sumber daya eksternal.

public:
 System::IO::Packaging::PackageRelationship ^ CreateRelationship(Uri ^ targetUri, System::IO::Packaging::TargetMode targetMode, System::String ^ relationshipType, System::String ^ id);

public System.IO.Packaging.PackageRelationship CreateRelationship (Uri targetUri, System.IO.Packaging.TargetMode targetMode, string relationshipType, string? id);

member this.CreateRelationship : Uri * System.IO.Packaging.TargetMode * string * string -> System.IO.Packaging.PackageRelationship

Public Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationship

Parameter

targetUri

Uri

URI bagian target.

targetMode

TargetMode

Salah satu nilai enumerasi. Misalnya, Internal jika bagian target berada di dalam Package; atau External jika target adalah sumber daya di luar Package.

relationshipType

String

Peran hubungan.

id

String

ID unik untuk hubungan tersebut.

Mengembalikan

PackageRelationship

Hubungan tingkat bagian antara PackagePart ini dengan PackagePart target atau sumber daya eksternal.

Pengecualian

InvalidOperationException

Bagian telah dihapus.

-atau-

Package tidak terbuka (Dispose(Boolean) atau Close() telah dipanggil).

ArgumentNullException

targetUri atau relationshipTypenull.

ArgumentOutOfRangeException

Parameter targetMode bukan nilai enumerasi TargetMode yang valid.

ArgumentException

Bagian yang diidentifikasi oleh targetUri adalah hubungan (target hubungan tidak boleh hubungan lain).

-atau-

targetMode ditentukan sebagai Internal tetapi targetUri adalah URI eksternal absolut.

IOException

Paket bersifat baca-saja (hubungan baru tidak dapat ditambahkan).

XmlException

id bukan pengidentifikasi XML yang valid.

-atau-

Bagian dengan id yang ditentukan sudah ada.

Keterangan

Hubungan tingkat bagian mendefinisikan hubungan antara bagian ini dan bagian target atau sumber daya. Hubungan tingkat bagian bisa menjadi salah satu dari dua bentuk.

• Antara sumber PackagePart ke PackagePart target di dalam Package.

• Antara sumber PackagePart ke sumber daya target di luar paket.

Dalam hubungan sebagian bagian sumber dianggap sebagai "pemilik" hubungan. Ketika bagian sumber dihapus, semua hubungan yang dimiliki oleh bagian juga dihapus. Proses pembuatan atau penghapusan hubungan tidak secara fisik mengubah bagian target atau sumber daya dengan cara apa pun.

id harus berupa pengidentifikasi XML yang valid. Jenis id adalah xsd:ID dan harus mengikuti konvensi penamaan yang ditentukan dalam XML Schema Bagian 2: Datatypes spesifikasi (lihat https://www.w3.org/TR/xmlschema-2/#ID).

Metode CreateRelationship tidak secara fisik mengubah bagian sumber, atau bagian target atau sumber daya dengan cara apa pun.

Target hubungan tidak boleh hubungan lain.

Jika ditentukan sebagai , harus merupakan URI relatif yang dibentuk sesuai dengan spesifikasi SintaksIs Generik RFC 3986Uniform Resource Identifier (URI). URI relatif internal dapat berupa jalur absolut yang dimulai dengan karakter garis miring ("/") seperti "/page1.xaml" atau "/images/picture4.jpg", atau jalur relatif seperti ".. /imagespicture1.jpg" yang menyelesaikan terhadap akar paket ("/") sebagai URI dasar.

Jika ditentukan sebagai , dapat berupa URI absolut atau relatif yang terbentuk sesuai dengan spesifikasi RFC 3986Uniform Resource Identifier (URI). "https://www.microsoft.com/page2.xml" adalah contoh URI absolut yang mereferensikan sumber daya target eksternal "page2.xml". "images/picture1.jpg" adalah contoh URI relatif yang juga mereferensikan sumber daya target eksternal "1.jpg" tetapi yang menyelesaikan terhadap URI paket itu sendiri.

relationshipType harus berupa URI yang dibentuk sesuai dengan spesifikasi RFC 3986Uniform Resource Identifier (URI) Generic Syntax. Jenis paket yang berbeda dapat menentukan jenis hubungan tingkat bagian yang berbeda. Tabel berikut ini memperlihatkan URI relationshipType tingkat bagian yang ditentukan untuk dokumen yang sesuai dengan Open XML Paper Specification (XPS).

Hubungan Part-Level Dokumen XPS	Jenis Hubungan URI
Definisi Tanda Tangan Digital	http://schemas.microsoft.com/xps/2005/06/signature-definitions
DiscardControl	http://schemas.microsoft.com/xps/2005/06/discard-control
DocumentStructure	http://schemas.microsoft.com/xps/2005/06/documentstructure
PrintTicket	http://schemas.microsoft.com/xps/2005/06/printticket
Sumber Daya yang Diperlukan	http://schemas.microsoft.com/xps/2005/06/required-resource
Font Terbatas	http://schemas.microsoft.com/xps/2005/06/restricted-font
StartPart	http://schemas.microsoft.com/xps/2005/06/fixedrepresentation
StoryFragments	http://schemas.microsoft.com/xps/2005/06/storyfragments

Untuk informasi selengkapnya tentang hubungan paket, lihat bagian 1.3 dari spesifikasi Open Packaging Conventions (OPC) yang tersedia untuk diunduh di .

Untuk informasi selengkapnya tentang dokumen XPS, lihat Open XML Paper Specification (XPS) tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-388/.

Lihat juga

• CreateRelationship
• DeleteRelationship(String)
• GetRelationship(String)
• GetRelationships()
• GetRelationshipsByType(String)
• Spesifikasi Konvensi Kemasan Terbuka