Bahasa

PackagePart.CreateRelationship Metode

Definisi

Ruang nama:
System.IO.Packaging
Rakitan:
System.IO.Packaging.dll
Rakitan:
WindowsBase.dll
Rakitan:
System.IO.Packaging.dll, WindowsBase.dll
Paket:
System.IO.Packaging v11.0.0-preview.7.26381.103

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

Overload

Nama Deskripsi
CreateRelationship(Uri, TargetMode, String)

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

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

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.

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 ini 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 Konvensi Kemasan Terbuka (OPC) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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

CreateRelationship(Uri, TargetMode, String)

Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs

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

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 ini PackagePart ke target PackagePart atau sumber daya eksternal.

Pengecualian

InvalidOperationException

Bagian telah dihapus.

-atau-

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

ArgumentNullException

targetUri atau relationshipType adalah null.

ArgumentOutOfRangeException

Parameter targetMode bukan nilai enumerasi yang valid TargetMode .

ArgumentException

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

-atau-

targetMode ditentukan sebagai Internal tetapi targetUri merupakan 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.

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 ini CreateRelationship tidak secara fisik mengubah bagian sumber, atau bagian target atau sumber daya dengan cara apa pun.

Target hubungan tidak boleh hubungan lain.

Jika targetMode ditentukan sebagai Internal, targetUri harus merupakan URI relatif yang dibentuk sesuai dengan spesifikasi SintaksIs Generik Pengidentifikasi Sumber Daya Seragam (URI)RFC 3986. 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 targetMode ditentukan sebagai External, targetUri dapat berupa URI absolut atau relatif yang dibentuk sesuai dengan spesifikasi SintaksIs Generik 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.

relationshipTypeharus berupa URI yang dibentuk sesuai dengan spesifikasi SintaksIs Generik Pengidentifikasi Sumber Daya Seragam (URI)RFC 3986. Jenis paket yang berbeda dapat menentukan jenis hubungan tingkat bagian yang berbeda. Tabel berikut ini memperlihatkan URI tingkat relationshipType bagian yang ditentukan untuk dokumen yang sesuai dengan Spesifikasi Kertas Open XML (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 Konvensi Kemasan Terbuka (OPC) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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

Lihat juga

Berlaku untuk

CreateRelationship(Uri, TargetMode, String, String)

Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs
Sumber:
PackagePart.cs

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

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);
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 ini PackagePart ke target PackagePart atau sumber daya eksternal.

Pengecualian

InvalidOperationException

Bagian telah dihapus.

-atau-

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

ArgumentNullException

targetUri atau relationshipType adalah null.

ArgumentOutOfRangeException

Parameter targetMode bukan nilai enumerasi yang valid TargetMode .

ArgumentException

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

-atau-

targetMode ditentukan sebagai Internal tetapi targetUri merupakan URI eksternal absolut.

IOException

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

XmlException

id bukan pengidentifikasi XML yang valid.

-atau-

Bagian dengan yang ditentukan id sudah ada.

Keterangan

Hubungan tingkat bagian mendefinisikan hubungan antara bagian ini dan bagian target atau sumber daya. Hubungan tingkat bagian dapat berupa salah satu dari dua bentuk:

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. Jenisnya id adalah xsd:ID dan harus mengikuti konvensi penamaan yang ditentukan dalam spesifikasi Skema XML Bagian 2: Datatypes (lihat https://www.w3.org/TR/xmlschema-2/#ID).

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

Target hubungan tidak boleh hubungan lain.

Jika targetMode ditentukan sebagai Internal, targetUri harus merupakan URI relatif yang dibentuk sesuai dengan spesifikasi SintaksIs Generik Pengidentifikasi Sumber Daya Seragam (URI)RFC 3986. 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 targetMode ditentukan sebagai External, targetUri dapat berupa URI absolut atau relatif yang dibentuk sesuai dengan spesifikasi SintaksIs Generik 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.

relationshipTypeharus berupa URI yang dibentuk sesuai dengan spesifikasi SintaksIs Generik Pengidentifikasi Sumber Daya Seragam (URI)RFC 3986. Jenis paket yang berbeda dapat menentukan jenis hubungan tingkat bagian yang berbeda. Tabel berikut ini memperlihatkan URI tingkat relationshipType bagian yang ditentukan untuk dokumen yang sesuai dengan Spesifikasi Kertas Open XML (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 Konvensi Kemasan Terbuka (OPC) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

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/.

Lihat juga

Berlaku untuk