Package.CreatePart Yöntem

Tanım

Ad Alanı:

System.IO.Packaging

Bütünleştirilmiş Kod:

System.IO.Packaging.dll

Paket:

System.IO.Packaging v11.0.0-preview.5.26302.115

Yeni bir paket bölümü oluşturur.

Aşırı Yüklemeler

Name	Description
CreatePart(Uri, String)	Belirli bir URI'ye ve içerik türüne sahip yeni bir sıkıştırılmamış bölüm oluşturur.
CreatePart(Uri, String, CompressionOption)	Belirli bir URI, içerik türü ve sıkıştırma seçeneğiyle yeni bir bölüm oluşturur.

Örnekler

Aşağıdaki örnekte, yeni PackagePart bir oluşturma ve ardından verileri bölümde depolama gösterilmektedir.

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

Açıklamalar

CreatePart yeni bölüm için boş Stream bir başlatma başlatır. yöntemi, PackagePart.GetStream bölümüyle ilişkili akış örneğine başvuru almak için kullanılabilir.

Paket parçaları hakkında daha fazla bilgi için adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/Open Packaging Conventions (OPC) belirtiminin 1.1. bölümüne bakın.

CreatePart(Uri, String)

Kaynak:

Package.cs

Belirli bir URI'ye ve içerik türüne sahip yeni bir sıkıştırılmamış bölüm oluşturur.

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

Parametreler

partUri

Uri

Yeni bölümün tekdüzen kaynak tanımlayıcısı (URI).

contentType

String

Veri akışının içerik türü.

Döndürülenler

PackagePart

Yeni oluşturulan bölüm.

Özel durumlar

ArgumentNullException

partUri veya contentType şeklindedir null.

ArgumentException

partUri geçerli PackagePart bir URI değil.

InvalidOperationException

Belirtilene partUri sahip bir bölüm pakette zaten var.

ObjectDisposedException

Paket açık değil (Dispose(Boolean) veya Close() çağrıldı).

IOException

Paket salt okunurdur (yeni bir bölüm eklenemez).

Örnekler

Aşağıdaki örnekte, yeni PackagePart bir oluşturma ve ardından verileri bölümde depolama gösterilmektedir.

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

Açıklamalar

CreatePart yeni bölüm için boş Stream bir başlatma başlatır. yöntemi, PackagePart.GetStream bölümüyle ilişkili akış örneğine başvuru almak için kullanılabilir.

Bölümü CompressionOption şudur CompressionOption.NotCompressed: .

Paket parçaları hakkında ek bilgi için adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/Open Packaging Conventions (OPC) belirtiminin 1.1. bölümüne bakın.

Devralanlara Notlar

CreatePart(Uri, String) dahili olarak türetilmiş sınıfın CreatePartCore(Uri, String, CompressionOption) yöntemini çağırarak, türetilmiş sınıfta uygulanan fiziksel biçimi temel alan bölümü oluşturur.

Ayrıca bkz.

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

CreatePart(Uri, String, CompressionOption)

Kaynak:

Package.cs

Belirli bir URI, içerik türü ve sıkıştırma seçeneğiyle yeni bir bölüm oluşturur.

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

Parametreler

partUri

Uri

Yeni bölümün URI'sini.

contentType

String

Veri akışının içerik türü.

compressionOption

CompressionOption

Veri akışı NotCompressed veya Normal sıkıştırma için sıkıştırma seçeneği.

Döndürülenler

PackagePart

Yeni oluşturulan bölüm.

Özel durumlar

ArgumentNullException

partUri veya contentType şeklindedir null.

ArgumentException

partUri geçerli PackagePart bir tekdüzen kaynak tanımlayıcısı (URI) değil.

InvalidOperationException

Belirtilene partUri sahip bir bölüm pakette zaten var.

ArgumentOutOfRangeException

Değer compressionOption geçerli değil.

ObjectDisposedException

Paket açık değil (Dispose(Boolean) veya Close() çağrıldı).

IOException

Paket salt okunurdur (yeni bir bölüm eklenemez).

Örnekler

Aşağıdaki örnekte, yeni PackagePart bir oluşturma ve ardından verileri bölümde depolama gösterilmektedir.

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

Açıklamalar

Varsayılan ZipPackage türetilmiş sınıf için CreatePart yöntemi yalnızca iki compressionOption değeri veya NotCompressed sıkıştırmayı Normal destekler. diğer CompressionOption değerleri Maximum, Fastveya SuperFast sıkıştırma kullanın Normal .

CreatePart yeni bölüm için boş Stream bir oluşturur. yöntemi, PackagePart.GetStream bölümüyle ilişkili akış örneğine başvuru almak için kullanılabilir.

Ek bilgi için adresinden indirilebilen https://www.ecma-international.org/publications-and-standards/standards/ecma-376/Open Packaging Conventions (OPC) belirtimine bakın.

Devralanlara Notlar

CreatePart(Uri, String, CompressionOption) dahili olarak türetilmiş sınıfın CreatePartCore(Uri, String, CompressionOption) yöntemini çağırarak, türetilmiş sınıfta uygulanan fiziksel biçimi temel alan bölümü oluşturur.

Ayrıca bkz.

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