TypeDescriptor.GetAssociation(Type, Object) Method

Definition

Returns an instance of the type associated with the specified primary object.

public static object GetAssociation (Type type, object primary);

Parameters

type
Type

The Type of the target component.

primary
Object

The primary object of the association.

Returns

An instance of the secondary type that has been associated with the primary object if an association exists; otherwise, primary if no specified association exists.

Exceptions

One or both of the parameters are null.

Remarks

If a previous association has been made for the type parameter using the CreateAssociation method, then the GetAssociation method returns the correct secondary object to invoke for the requested type. Otherwise, GetAssociation searches for a compatible designer for type and returns the designer if one is found. This method never returns null.

A WeakReference is used to maintain the association between the primary and secondary object; therefore, this method does not prevent either the primary or secondary object from being finalized and reclaimed by garbage collection.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7 (package-provided), 4.7, 4.7.1 (package-provided), 4.7.1, 4.7.2 (package-provided), 4.7.2, 4.8 (package-provided), 4.8, 4.8.1
.NET Standard 2.0, 2.1

See also