ConsumerConnectionPoint.SetObject(Control, Object) Method

Definition

Invokes the callback method in a consumer control and retrieves the interface instance from a provider control.

public virtual void SetObject(System.Web.UI.Control control, object data);

Parameters

control
Control

The consumer control associated with a consumer connection point.

data
Object

The interface instance returned from a provider control.

Exceptions

control is null.

Remarks

This method receives an interface instance from a provider that contains data for the consumer control.

The SetObject method is called by WebPartConnection objects when a connection is being activated. This is a critical step that is part of initiating a connection and enabling two controls to share data.

The consumer control in a connection must be able to work with the same type of interface as the provider. If it does not, the controls are incompatible and a WebPartTransformer object must be used to establish a connection.

Applies to

Product Versions
.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, 4.7.1, 4.7.2, 4.8, 4.8.1