Package.CreatePart Yöntem

Tanım

Ad Alanı:

System.IO.Packaging

Bütünleştirilmiş Kod:

System.IO.Packaging.dll

Paket:

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

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

Aşırı Yüklemeler

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şlatıyor. 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

Belirtilen partUri bölümü paketinde 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şlatıyor. 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) türetilmiş sınıfta uygulanan fiziksel biçimi temel alarak bölümü oluşturmak için türetilmiş sınıfın CreatePartCore(Uri, String, CompressionOption) yöntemini dahili olarak çağırır.

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

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

Belirtilen partUri bölümü paketinde 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 CreatePart için yöntemi yalnızca iki compressionOption değeri veya Normal sıkıştırmayı NotCompressed destekler. diğer CompressionOption , Fastveya SuperFast değerleri Maximumsıkıştırmayı kullanırNormal.

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) türetilmiş sınıfta uygulanan fiziksel biçimi temel alarak bölümü oluşturmak için türetilmiş sınıfın CreatePartCore(Uri, String, CompressionOption) yöntemini dahili olarak çağırır.

Ayrıca bkz.

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