Bagikan melalui


Package.CreateRelationship Metode

Definisi

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.

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

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.

  • 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

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

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.

  • 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

Berlaku untuk