This documentation is archived and is not being maintained.

Package.GetRelationship Method

Returns the package-level relationship with a given identifier.

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

Public Function GetRelationship ( _
	id As String _
) As PackageRelationship


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

Return Value

Type: System.IO.Packaging.PackageRelationship
The package-level relationship with the specified id.


id is Nothing.


id is not a valid XML identifier.


A relationship with the specified id is not in the package.


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


The package is write-only.

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

For additional information about packaging and package relationships, see section 1.3 of the Open Packaging Conventions (OPC) specification available for download at

.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.