Package.DeletePart(Uri) Method

Definition

Namespace:

System.IO.Packaging

Assembly:

System.IO.Packaging.dll

Package:

System.IO.Packaging v8.0.0

Source:

Package.cs

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.

See also

• CreatePart
• CreatePartUri(Uri)
• GetPartUri(Uri)
• ResolvePartUri(Uri, Uri)