Export (0) Print
Expand All

PackagePart.DeleteRelationship Method

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.

ExceptionCondition
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

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Show:
© 2014 Microsoft