Package.CreatePartCore(Uri, String, CompressionOption) Method

Definition

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Package:

System.IO.Packaging v8.0.0

Source:

Package.cs

When overridden in a derived class, creates a new part in the package.

protected:
 abstract System::IO::Packaging::PackagePart ^ CreatePartCore(Uri ^ partUri, System::String ^ contentType, System::IO::Packaging::CompressionOption compressionOption);

protected abstract System.IO.Packaging.PackagePart CreatePartCore (Uri partUri, string contentType, System.IO.Packaging.CompressionOption compressionOption);

abstract member CreatePartCore : Uri * string * System.IO.Packaging.CompressionOption -> System.IO.Packaging.PackagePart

Protected MustOverride Function CreatePartCore (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePart

Parameters

partUri

Uri

The uniform resource identifier (URI) for the part being created.

contentType

String

The content type of the data stream.

compressionOption

CompressionOption

The compression option for the data stream.

Returns

PackagePart

The created part.

Remarks

The derived CreatePartCore method is called by the CreatePart method to create a part based on the physical format implemented in the derived class.

By default, a ZipPackage derived class implementation of the abstract Package class is provided and used. In the default operation, CreatePart internally calls CreatePartCore of the ZipPackage class to create a new part in a ZIP file.

For the default ZipPackage derived class, the CreatePartCore method only supports two compressionOption values, NotCompressed or Normal compression. Other CompressionOption values of Maximum, Fast, or SuperFast use Normal compression.

For more information about the package model and package parts, see Chapter 1 of the Open Packaging Conventions (OPC) specification available for download at https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Notes to Implementers

The derived CreatePartCore(Uri, String, CompressionOption) implementation should make no assumptions about the order or operations performed by the CreatePart method that calls it.

See also

• DeletePartCore(Uri)