Package.CreateRelationship Metode
Definisi
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 paket ke bagian tertentu.
Overload
| CreateRelationship(Uri, TargetMode, String) |
Membuat hubungan tingkat paket ke bagian dengan URI, mode target, dan jenis hubungan tertentu. |
| CreateRelationship(Uri, TargetMode, String, String) |
Membuat hubungan tingkat paket ke bagian dengan URI, mode target, jenis hubungan, dan pengidentifikasi (ID) tertentu. |
Contoh
Contoh berikut mengilustrasikan pembuatan PackageRelationship antara bagian dokumen akar Package dan .
// Add the Document part to the Package
PackagePart packagePartDocument =
package.CreatePart(partUriDocument,
System.Net.Mime.MediaTypeNames.Text.Xml);
// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
documentPath, FileMode.Open, FileAccess.Read))
{
CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.
// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
TargetMode.Internal,
PackageRelationshipType);
' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)
' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.
' Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri, TargetMode.Internal, PackageRelationshipType)
Keterangan
Hubungan tingkat paket mendefinisikan hubungan antara paket dan bagian target atau sumber daya terkait. Hubungan tingkat paket bisa menjadi salah satu dari dua bentuk.
- Antara ke Package target PackagePart di dalam paket.
- Package Antara ke sumber daya target di luar paket.
Dalam hubungan paket, paket dianggap sebagai "pemilik" hubungan. Ketika paket dihapus, semua hubungan yang dimiliki oleh paket juga dihapus. Proses pembuatan atau penghapusan hubungan tidak secara fisik mengubah bagian target atau sumber daya dengan cara apa pun.
Untuk informasi tambahan, lihat spesifikasi Open Packaging Conventions (OPC) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
CreateRelationship(Uri, TargetMode, String)
- Sumber:
- Package.cs
- Sumber:
- Package.cs
- Sumber:
- Package.cs
- Sumber:
- Package.cs
Membuat hubungan tingkat paket ke bagian dengan URI, mode target, dan jenis hubungan 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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String) As PackageRelationshipParameter
- targetUri
- Uri
Pengidentifikasi sumber daya seragam (URI) dari bagian target.
- targetMode
- TargetMode
Menunjukkan apakah bagian target adalah Internal atau External ke paket.
- relationshipType
- String
URI yang secara unik mendefinisikan peran hubungan.
Mengembalikan
Hubungan tingkat paket dengan bagian yang ditentukan.
Pengecualian
targetUri atau relationshipType adalah null.
Bagiannya targetUri adalah PackageRelationship, atau targetMode adalah Internal dan targetUri merupakan URI absolut.
Nilai untuk targetMode tidak valid.
Paket tidak terbuka (Dispose(Boolean) atau Close() telah dipanggil).
Paket bersifat baca-saja.
Contoh
Contoh berikut mengilustrasikan cara menggunakan CreateRelationship untuk membuat PackageRelationship antara bagian dokumen akar Package dan .
// Add the Document part to the Package
PackagePart packagePartDocument =
package.CreatePart(partUriDocument,
System.Net.Mime.MediaTypeNames.Text.Xml);
// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
documentPath, FileMode.Open, FileAccess.Read))
{
CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.
// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
TargetMode.Internal,
PackageRelationshipType);
' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)
' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.
' Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri, TargetMode.Internal, PackageRelationshipType)
Keterangan
Hubungan tingkat paket mendefinisikan hubungan antara paket dan bagian target atau sumber daya terkait. Hubungan tingkat paket bisa menjadi salah satu dari dua bentuk.
Dalam hubungan paket, paket dianggap sebagai "pemilik" hubungan. Ketika paket dihapus, semua hubungan yang dimiliki oleh paket juga dihapus.
CreateRelationship secara fisik tidak mengubah bagian target atau sumber daya dengan cara apa pun.
Target hubungan tidak boleh menjadi 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 mengatasi akar paket ("/") sebagai URI dasar.
Jika targetMode ditentukan sebagai External, targetUri dapat berupa URI absolut atau relatif yang dibentuk sesuai dengan spesifikasi SintaksIs Generik Pengidentifikasi Sumber Daya Seragam (URI) RFC 3986 . http://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 diselesaikan terhadap URI paket itu sendiri.
relationshipType harus berupa URI yang dibentuk sesuai dengan spesifikasi SintaksIs Generik Pengidentifikasi Sumber Daya Seragam (URI) RFC 3986 . Tabel berikut menunjukkan URI tingkat relationshipType paket yang ditentukan oleh spesifikasi Open Packaging Conventions (OPC).
| Hubungan tingkat paket | Jenis Hubungan URI |
|---|---|
| Properti Inti | http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties |
| Tanda Tangan Digital | http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/signature |
| Sertifikat Tanda Tangan Digital | http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/certificate |
| Asal Tanda Tangan Digital | http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/origin |
| Gambar mini | http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail |
Untuk informasi selengkapnya tentang kemasan dan hubungan paket, lihat bagian 1.3 dari spesifikasi Open Packaging Conventions (OPC) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Lihat juga
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- RelationshipExists(String)
Berlaku untuk
CreateRelationship(Uri, TargetMode, String, String)
- Sumber:
- Package.cs
- Sumber:
- Package.cs
- Sumber:
- Package.cs
- Sumber:
- Package.cs
Membuat hubungan tingkat paket ke bagian dengan URI, mode target, jenis hubungan, dan pengidentifikasi (ID) 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.PackageRelationshipPublic Function CreateRelationship (targetUri As Uri, targetMode As TargetMode, relationshipType As String, id As String) As PackageRelationshipParameter
- targetUri
- Uri
Pengidentifikasi sumber daya seragam (URI) dari bagian target.
- targetMode
- TargetMode
Menunjukkan apakah bagian target adalah Internal atau External ke paket.
- relationshipType
- String
URI yang secara unik mendefinisikan peran hubungan.
- id
- String
Pengidentifikasi XML unik.
Mengembalikan
Hubungan tingkat paket dengan bagian yang ditentukan.
Pengecualian
targetUri atau relationshipType adalah null.
Bagiannya targetUri adalah PackageRelationship, atau targetMode adalah Internal dan targetUri merupakan URI absolut.
Nilai untuk targetMode tidak valid.
Paket tidak terbuka (Dispose(Boolean) atau Close() telah dipanggil).
Paket bersifat baca-saja.
id bukan pengidentifikasi XML yang valid; atau bagian dengan yang ditentukan id sudah terjadi dalam paket.
Contoh
Contoh berikut mengilustrasikan cara menggunakan CreateRelationship untuk membuat PackageRelationship antara bagian dokumen akar Package dan .
// Add the Document part to the Package
PackagePart packagePartDocument =
package.CreatePart(partUriDocument,
System.Net.Mime.MediaTypeNames.Text.Xml);
// Copy the data to the Document Part
using (FileStream fileStream = new FileStream(
documentPath, FileMode.Open, FileAccess.Read))
{
CopyStream(fileStream, packagePartDocument.GetStream());
}// end:using(fileStream) - Close and dispose fileStream.
// Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri,
TargetMode.Internal,
PackageRelationshipType);
' Add the Document part to the Package
Dim packagePartDocument As PackagePart = package.CreatePart(partUriDocument, System.Net.Mime.MediaTypeNames.Text.Xml)
' Copy the data to the Document Part
Using fileStream As New FileStream(documentPath, FileMode.Open, FileAccess.Read)
CopyStream(fileStream, packagePartDocument.GetStream())
End Using ' end:using(fileStream) - Close and dispose fileStream.
' Add a Package Relationship to the Document Part
package.CreateRelationship(packagePartDocument.Uri, TargetMode.Internal, PackageRelationshipType)
Keterangan
Hubungan tingkat paket mendefinisikan hubungan antara paket dan bagian target atau sumber daya terkait. Hubungan tingkat paket bisa menjadi salah satu dari dua bentuk.
Dalam hubungan paket, paket dianggap sebagai "pemilik" hubungan. Ketika paket dihapus, semua hubungan yang dimiliki oleh paket juga dihapus.
CreateRelationship secara fisik tidak mengubah bagian target atau sumber daya dengan cara apa pun.
Target hubungan tidak boleh menjadi hubungan lain.
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: Jenis data (lihat https://www.w3.org/TR/xmlschema-2/#ID).
Jika id ditentukan sebagai null ID unik akan dibuat secara otomatis. String id kosong yang ditentukan tidak valid.
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 mengatasi akar paket ("/") sebagai URI dasar.
Jika targetMode ditentukan sebagai External, targetUri dapat berupa URI absolut atau relatif yang dibentuk sesuai dengan spesifikasi SintaksIs Generik Pengidentifikasi Sumber Daya Seragam (URI) RFC 3986 . http://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 diselesaikan terhadap URI paket itu sendiri.
relationshipType harus berupa URI yang dibentuk sesuai dengan spesifikasi SintaksIs Generik Pengidentifikasi Sumber Daya Seragam (URI) RFC 3986 . Tabel berikut menunjukkan URI tingkat relationshipType paket yang ditentukan oleh spesifikasi Open Packaging Conventions (OPC).
| Hubungan tingkat paket | Jenis Hubungan URI |
|---|---|
| Properti Inti | http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties |
| Tanda Tangan Digital | http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/signature |
| Sertifikat Tanda Tangan Digital | http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/certificate |
| Asal Tanda Tangan Digital | http://schemas.openxmlformats.org/package/2006/relationships/digital-signature/origin |
| Gambar mini | http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail |
Untuk informasi tambahan tentang kemasan dan hubungan paket, lihat bagian 1.3 dari spesifikasi Open Packaging Conventions (OPC) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.
Lihat juga
- CreateRelationship(Uri, TargetMode, String)
- DeleteRelationship(String)
- GetRelationship(String)
- GetRelationships()
- GetRelationshipsByType(String)
- RelationshipExists(String)
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk