This documentation is archived and is not being maintained.

TypeDescriptor.CreateAssociation Method

Creates a primary-secondary association between two objects.

Namespace: System.ComponentModel
Assembly: System (in system.dll)

public static void CreateAssociation (
	Object primary,
	Object secondary
public static void CreateAssociation (
	Object primary, 
	Object secondary
public static function CreateAssociation (
	primary : Object, 
	secondary : Object
Not applicable.



The primary Object.


The secondary Object.

Exception typeCondition


One or both of the parameters are a null reference (Nothing in Visual Basic).


primary is equal to secondary.

The CreateAssociation method creates an association between a primary and a secondary object. Once an association is created, a designer or other filtering mechanism can add properties that route to either object into the primary object's property set. When a property invocation is made against the primary object, the GetAssociation method will be called to resolve the actual object instance that is related to its type parameter.

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

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0