PackagePart.DeleteRelationship(String) Method

Reference

Definition

Namespace:: System.IO.Packaging

Assembly:: System.IO.Packaging.dll

Assembly:: WindowsBase.dll

Package:: System.IO.Packaging v8.0.1

Package:: System.IO.Packaging v9.0.0-rc.2.24473.5

Source:: PackagePart.cs

Source:: PackagePart.cs

Source:: PackagePart.cs

Source:: PackagePart.cs

Source:: PackagePart.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 specified part-level PackageRelationship.

public:
 void DeleteRelationship(System::String ^ id);

public void DeleteRelationship (string id);

member this.DeleteRelationship : string -> unit

Public Sub DeleteRelationship (id As String)

Parameters

id: String

The Id of the relationship to delete.

Exceptions

InvalidOperationException

The part has been deleted.

-or-

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

ArgumentNullException

id is null.

IOException

The package is read-only (relationships cannot be deleted).

XmlException

id is not a valid XML identifier.

Remarks

id must be a valid XML identifier. The id type is xsd:ID and must follow the naming conventions prescribed in the XML Schema Part 2: Datatypes specification (see https://www.w3.org/TR/xmlschema-2/#ID).

If the specified id does not match the Id for any of the relationships that are owned by this part, no relationship is deleted and no exception is thrown.

Other than deleting the specified relationship, the DeleteRelationship method does not physically change either this part or the target part.

Applies to

Share via