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

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

Nama	Deskripsi
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 tertentu, mode target, jenis hubungan, dan pengidentifikasi (ID).

Contoh

Contoh berikut mengilustrasikan pembuatan PackageRelationship antara bagian dokumen akar Package dan antara bagian.

// 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 target Package ke PackagePart dalam paket.
Antara sumber Package daya ke 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 Konvensi Kemasan Terbuka (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

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

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

Parameter

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

PackageRelationship

Hubungan tingkat paket ke bagian yang ditentukan.

Pengecualian

ArgumentNullException

targetUri atau relationshipType adalah null.

ArgumentException

Bagiannya targetUri adalah PackageRelationship, atau targetMode adalah Internal dan targetUri merupakan URI absolut.

ArgumentOutOfRangeException

Nilai untuk targetMode tidak valid.

ObjectDisposedException

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

IOException

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.

Package Antara ke bagian target dalam paket.
Antara sumber Package daya ke target di luar paket.

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

Lihat juga

Berlaku untuk

CreateRelationship(Uri, TargetMode, String, String)

Sumber:: Package.cs

Sumber:: Package.cs

Sumber:: Package.cs

Sumber:: Package.cs

Sumber:: Package.cs

Sumber:: Package.cs

Sumber:: Package.cs

Sumber:: Package.cs

Membuat hubungan tingkat paket ke bagian dengan URI tertentu, mode target, jenis hubungan, dan pengidentifikasi (ID).

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

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

PackageRelationship

Hubungan tingkat paket ke bagian yang ditentukan.

Pengecualian

ArgumentNullException

targetUri atau relationshipType adalah null.

ArgumentException

Bagiannya targetUri adalah PackageRelationship, atau targetMode adalah Internal dan targetUri merupakan URI absolut.

ArgumentOutOfRangeException

Nilai untuk targetMode tidak valid.

ObjectDisposedException

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

IOException

Paket bersifat baca saja.

XmlException

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.

Package Antara ke bagian target dalam paket.
Antara sumber Package daya ke target di luar paket.

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 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: Datatypes (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.

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 hubungan kemasan dan 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/.

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?