Bagikan melalui


Package.CreatePart Metode

Definisi

Membuat bagian paket baru.

Overload

CreatePart(Uri, String)

Membuat bagian baru yang tidak dikompresi dengan URI dan jenis konten tertentu.

CreatePart(Uri, String, CompressionOption)

Membuat bagian baru dengan opsi URI, jenis konten, dan pemadatan tertentu.

Contoh

Contoh berikut menunjukkan cara membuat data baru PackagePart lalu menyimpan data ke dalam bagian tersebut.

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

Keterangan

CreatePart menginisialisasi kosong Stream untuk bagian baru. Metode PackagePart.GetStream ini dapat digunakan untuk mendapatkan referensi ke instans aliran yang terkait dengan bagian tersebut.

Untuk informasi selengkapnya tentang bagian paket, lihat bagian 1.1 dari spesifikasi Open Packaging Conventions (OPC) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

CreatePart(Uri, String)

Sumber:
Package.cs
Sumber:
Package.cs
Sumber:
Package.cs
Sumber:
Package.cs

Membuat bagian baru yang tidak dikompresi dengan URI dan jenis konten tertentu.

public:
 System::IO::Packaging::PackagePart ^ CreatePart(Uri ^ partUri, System::String ^ contentType);
public System.IO.Packaging.PackagePart CreatePart (Uri partUri, string contentType);
member this.CreatePart : Uri * string -> System.IO.Packaging.PackagePart
Public Function CreatePart (partUri As Uri, contentType As String) As PackagePart

Parameter

partUri
Uri

Pengidentifikasi sumber daya seragam (URI) dari bagian baru.

contentType
String

Jenis konten aliran data.

Mengembalikan

Bagian yang baru dibuat.

Pengecualian

partUri atau contentType adalah null.

partUri bukan URI yang valid PackagePart .

Bagian dengan yang ditentukan partUri sudah ada dalam paket.

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

Paket bersifat baca-saja (bagian baru tidak dapat ditambahkan).

Contoh

Contoh berikut menunjukkan cara membuat data baru PackagePart lalu menyimpan data ke dalam bagian tersebut.

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

Keterangan

CreatePart menginisialisasi kosong Stream untuk bagian baru. Metode PackagePart.GetStream ini dapat digunakan untuk mendapatkan referensi ke instans aliran yang terkait dengan bagian tersebut.

Bagiannya CompressionOption adalah CompressionOption.NotCompressed.

Untuk informasi tambahan tentang bagian paket, lihat bagian 1.1 dalam spesifikasi Open Packaging Conventions (OPC) yang tersedia untuk diunduh di https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Catatan Bagi Inheritor

CreatePart(Uri, String) secara internal memanggil metode kelas CreatePartCore(Uri, String, CompressionOption) turunan untuk benar-benar membuat bagian berdasarkan format fisik yang diterapkan di kelas turunan.

Lihat juga

Berlaku untuk

CreatePart(Uri, String, CompressionOption)

Sumber:
Package.cs
Sumber:
Package.cs
Sumber:
Package.cs
Sumber:
Package.cs

Membuat bagian baru dengan opsi URI, jenis konten, dan pemadatan tertentu.

public:
 System::IO::Packaging::PackagePart ^ CreatePart(Uri ^ partUri, System::String ^ contentType, System::IO::Packaging::CompressionOption compressionOption);
public System.IO.Packaging.PackagePart CreatePart (Uri partUri, string contentType, System.IO.Packaging.CompressionOption compressionOption);
member this.CreatePart : Uri * string * System.IO.Packaging.CompressionOption -> System.IO.Packaging.PackagePart
Public Function CreatePart (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePart

Parameter

partUri
Uri

URI bagian baru.

contentType
String

Jenis konten aliran data.

compressionOption
CompressionOption

Opsi pemadatan untuk aliran data, NotCompressed atau Normal pemadatan.

Mengembalikan

Bagian yang baru dibuat.

Pengecualian

partUri atau contentType adalah null.

partUri bukan pengidentifikasi sumber daya seragam (URI) yang valid PackagePart .

Bagian dengan yang ditentukan partUri sudah ada dalam paket.

Nilai compressionOption tidak valid.

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

Paket bersifat baca-saja (bagian baru tidak dapat ditambahkan).

Contoh

Contoh berikut menunjukkan cara membuat data baru PackagePart lalu menyimpan data ke dalam bagian tersebut.

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

Keterangan

Untuk kelas turunan default ZipPackage , CreatePart metode hanya mendukung dua compressionOption nilai, NotCompressed atau Normal pemadatan. Nilai lain CompressionOption dari Maximum, Fast, atau SuperFast gunakan Normal pemadatan.

CreatePart membuat kosong Stream untuk bagian baru. Metode PackagePart.GetStream ini dapat digunakan untuk mendapatkan referensi ke instans aliran yang terkait dengan bagian tersebut.

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

Catatan Bagi Inheritor

CreatePart(Uri, String, CompressionOption) secara internal memanggil metode kelas CreatePartCore(Uri, String, CompressionOption) turunan untuk benar-benar membuat bagian berdasarkan format fisik yang diterapkan di kelas turunan.

Lihat juga

Berlaku untuk