PackagePart.DeleteRelationship Method (String)

 

Deletes a specified part-level PackageRelationship.

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

public void DeleteRelationship(
	string id
)

Parameters

id
Type: System.String

The Id of the relationship to delete.

Exception Condition
InvalidOperationException

The part has been deleted.

-or-

The Package is not open (Dispose 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.

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 http://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.

.NET Framework
Available since 3.0
Return to top
Show: