PackagePart.CreateRelationship Metode
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membuat hubungan tingkat bagian antara PackagePart ini ke target tertentu PackagePart atau sumber daya eksternal.
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. |
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
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/.
- Sumber:
- PackagePart.cs
- Sumber:
- PackagePart.cs
- Sumber:
- PackagePart.cs
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
Hubungan tingkat bagian antara PackagePart ini dengan PackagePart target atau sumber daya eksternal.
Pengecualian
targetUri
atau relationshipType
null
.
Parameter targetMode
bukan nilai enumerasi TargetMode yang valid.
Bagian yang diidentifikasi oleh targetUri
adalah hubungan (target hubungan tidak boleh hubungan lain).
-atau-
targetMode
ditentukan sebagai Internal tetapi targetUri
adalah URI eksternal absolut.
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
Jika "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
Untuk informasi selengkapnya tentang dokumen XPS, lihat
Lihat juga
- CreateRelationship
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- Spesifikasi Konvensi Kemasan Terbuka
Berlaku untuk
.NET 9 (package-provided) dan versi lainnya
Produk | Versi |
---|---|
.NET | Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided) |
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
- Sumber:
- PackagePart.cs
- Sumber:
- PackagePart.cs
- Sumber:
- PackagePart.cs
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);
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
Hubungan tingkat bagian antara PackagePart ini dengan PackagePart target atau sumber daya eksternal.
Pengecualian
targetUri
atau relationshipType
null
.
Parameter targetMode
bukan nilai enumerasi TargetMode yang valid.
Bagian yang diidentifikasi oleh targetUri
adalah hubungan (target hubungan tidak boleh hubungan lain).
-atau-
targetMode
ditentukan sebagai Internal tetapi targetUri
adalah URI eksternal absolut.
Paket bersifat baca-saja (hubungan baru tidak dapat ditambahkan).
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
Jika
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
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
Berlaku untuk
.NET 9 (package-provided) dan versi lainnya
Produk | Versi |
---|---|
.NET | Core 1.0, Core 1.1, 8 (package-provided), 9 (package-provided) |
.NET Framework | 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
Windows Desktop | 3.0, 3.1, 5, 6, 7, 8, 9 |
Umpan balik .NET
.NET adalah proyek sumber terbuka. Pilih tautan untuk memberikan umpan balik: