This documentation is archived and is not being maintained.

PackagePart.GetRelationship Method

Returns the relationship that has a specified Id.

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

public PackageRelationship GetRelationship(
	string id


Type: System.String
The Id of the relationship to return.

Return Value

Type: System.IO.Packaging.PackageRelationship
The relationship that matches the specified id.


id is null.


id is not a valid XML identifier.


relationshipType is an empty string.


The part has been deleted.


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


A relationship with the specified id does not exist in the package.


The package is write-only (relationship information cannot be read).

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

You can use the RelationshipExists method to determine if a relationship with a specified Id is owned by this part.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later)

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