Package.CreateRelationship Metode

Definisi

Ruang nama:

System.IO.Packaging

Rakitan:

System.IO.Packaging.dll

Paket:

System.IO.Packaging v9.0.0-rc.1.24431.7

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

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 dengan 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.
• 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.

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)

CreateRelationship(Uri, TargetMode, String, String)

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);

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 dengan 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.
• 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.

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)