Package::CreatePart Method (Uri^, String^)


Creates a new uncompressed part with a given URI and content type.

Namespace:   System.IO.Packaging
Assembly:  WindowsBase (in WindowsBase.dll)

PackagePart^ CreatePart(
	Uri^ partUri,
	String^ contentType


Type: System::Uri^

The uniform resource identifier (URI) of the new part.

Type: System::String^

The content type of the data stream.

Return Value

Type: System.IO.Packaging::PackagePart^

The new created part.

Exception Condition

partUri or contentType is null.


partUri is not a valid PackagePart URI.


A part with the specified partUri is already present in the package.


The package is not open (Dispose or Close has been called).


The package is read-only (a new part cannot be added).

CreatePart initializes an empty Stream for the new part. The PackagePart::GetStream method can be used to obtain a reference to the stream instance associated with the part.

The part CompressionOption is CompressionOption::NotCompressed.

For additional information about package parts, see section 1.1 in the Open Packaging Conventions (OPC) specification available for download at

Notes to Inheritors:

CreatePart internally calls the derived class's CreatePartCore method to actually create the part based on the physical format implemented in the derived class.

The following example shows how to create a new PackagePart and then store data into the part. For the complete sample, see Writing a Package Sample.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 3.0
Return to top