Language

ControlParameter.ControlID Property

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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

public:
 property System::String ^ ControlID { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.WebControls.ControlIDConverter))]
public string ControlID { get; set; }
[]
member this.ControlID : string with get, set
Public Property ControlID As String

Property Value

String

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

Attributes
TypeConverterAttribute

Examples

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.



  
    ASP.NET Example


    


      

          Sales Representative
          Sales Manager
          Vice President, Sales
      


      
          
              
          
      

      

      


    

  




  
    ASP.NET Example


    


      

          Sales Representative
          Sales Manager
          Vice President, Sales

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.

<%@ Page language="c#"%>

   



  
    ASP.NET Example


    

      
Show Orders For:


      

      
      


      
        
          
          
        
      

      

      
      

    

  


<%@ Page language="VB"%>





  
    ASP.NET Example


    

      
Show Orders For:

Remarks

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.

Applies to

See also