Package.CreatePart Metode

Definisi

Ruang nama:

System.IO.Packaging

Rakitan:

System.IO.Packaging.dll

Paket:

System.IO.Packaging v9.0.0-preview.3.24172.9

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

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

PackagePart

Bagian yang baru dibuat.

Pengecualian

ArgumentNullException

partUri atau contentType adalah null.

ArgumentException

partUri bukan URI yang valid PackagePart .

InvalidOperationException

Bagian dengan yang ditentukan partUri sudah ada dalam paket.

ObjectDisposedException

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

IOException

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

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart

CreatePart(Uri, String, CompressionOption)

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

PackagePart

Bagian yang baru dibuat.

Pengecualian

ArgumentNullException

partUri atau contentType adalah null.

ArgumentException

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

InvalidOperationException

Bagian dengan yang ditentukan partUri sudah ada dalam paket.

ArgumentOutOfRangeException

Nilai compressionOption tidak valid.

ObjectDisposedException

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

IOException

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

• DeletePart(Uri)
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)
• ZipPackagePart