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)

public:
PackagePart^ CreatePart(
	Uri^ partUri,
	String^ contentType
)

Parameters

partUri
Type: System::Uri^

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

contentType
Type: System::String^

The content type of the data stream.

Return Value

Type: System.IO.Packaging::PackagePart^

The new created part.

Exception Condition
ArgumentNullException

partUri or contentType is null.

ArgumentException

partUri is not a valid PackagePart URI.

InvalidOperationException

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

ObjectDisposedException

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

IOException

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 http://go.microsoft.com/fwlink/?LinkID=71255.

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
Show: