Package.CreatePartCore(Uri, String, CompressionOption) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.PackagePartProtected MustOverride Function CreatePartCore (partUri As Uri, contentType As String, compressionOption As CompressionOption) As PackagePartParameters
- 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
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.
