ControlParameter::ControlID Property

 

Specifies the name of the control that the ControlParameter object binds to.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

public:
[TypeConverterAttribute((ControlIDConverter^::typeid))]
property String^ ControlID {
	String^ get();
	void set(String^ value);
}

Property Value

Type: System::String^

A string that represents the name of a Web server control.

The ControlID property is a required property that identifies the Control instance that the ControlParameter object binds to at run time.

Typically, the ControlID and PropertyName properties are set for the Evaluate method to correctly bind to a control. If you do not set the ControlID property, the Evaluate method throws an ArgumentException exception when called.

The following code example demonstrates how to use a ControlParameter object to bind data displayed in a ListBox control to the selected value of a DropDownList control in a declarative scenario. The ControlParameter object is added to the SelectParameters collection of the SqlDataSource control on the form, and corresponds to the "@Title" placeholder text in the SelectCommand property.

No code example is currently available or this language may not be supported.

The following code example demonstrates how to set the ControlID and PropertyName properties to identify the control that a ControlParameter object is bound to. The example populates a ListBox control with values. The SelectedValue property of the ListBox control is used to filter data retrieved by a SqlDataSource control and displayed by a GridView control.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 2.0
Return to top
Show: