TypeDescriptor.CreateAssociation Method

Creates a primary-secondary association between two objects.

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

[PermissionSetAttribute(SecurityAction.LinkDemand, Name = "FullTrust")]
public static void CreateAssociation(
	Object primary,
	Object secondary
)

Parameters

primary
Type: System.Object

The primary Object.

secondary
Type: System.Object

The secondary Object.

ExceptionCondition
ArgumentNullException

One or both of the parameters are null.

ArgumentException

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.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft