Package.DeletePart(Uri) Method

Reference

Definition

Namespace:: System.IO.Packaging

Assembly:: System.IO.Packaging.dll

Assembly:: WindowsBase.dll

Package:: System.IO.Packaging v9.0.0

Source:: Package.cs

Source:: Package.cs

Source:: Package.cs

Source:: Package.cs

Source:: Package.cs

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.

Deletes a part with a given URI from the package.

public:
 void DeletePart(Uri ^ partUri);

public void DeletePart (Uri partUri);

member this.DeletePart : Uri -> unit

Public Sub DeletePart (partUri As Uri)

Parameters

partUri: Uri

The URI of the part to delete.

Exceptions

ArgumentNullException

partUri is null.

ArgumentException

partUri is not a valid PackagePart URI.

ObjectDisposedException

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

IOException

The package is read-only.

Remarks

partUri must be a relative URI that consists of an absolute path which starts with a forward slash ("/") character. The absolute path is relative to the package root and is formed according to the RFC 3986 Uniform Resource Identifier (URI) Generic Syntax specification. "/page1.xaml" and "/images/picture4.jpg" are examples of valid part URIs.

No exception is raised if a part with the specified partUri is not in the package. (You can use the PartExists method to determine whether a part with a specified partUri is in the package.)

For additional information, see the Open Packaging Conventions (OPC) specification available for download at https://www.ecma-international.org/publications-and-standards/standards/ecma-376/.

Notes to Inheritors

DeletePart(Uri) internally calls the derived class's DeletePartCore(Uri) method to actually delete the part based on the physical format implemented in the derived class.

Applies to

Jaa