DropDownList Classe

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un controllo che consente all'utente di selezionare un singolo elemento da un elenco a discesa.

public ref class DropDownList : System::Web::UI::WebControls::ListControl, System::Web::UI::IPostBackDataHandler

[System.Web.UI.ValidationProperty("SelectedItem")]
public class DropDownList : System.Web.UI.WebControls.ListControl, System.Web.UI.IPostBackDataHandler

[<System.Web.UI.ValidationProperty("SelectedItem")>]
type DropDownList = class
    inherit ListControl
    interface IPostBackDataHandler

Public Class DropDownList
Inherits ListControl
Implements IPostBackDataHandler

Ereditarietà: Object

Control

WebControl

ListControl
DropDownList

Ereditarietà: Object

Control

WebControl

BaseDataBoundControl

DataBoundControl

ListControl
DropDownList

Attributi: ValidationPropertyAttribute

Implementazioni: IPostBackDataHandler

Esempio

Nell'esempio di codice seguente viene illustrato come creare un DropDownList controllo contenente quattro elementi.

<%@ Page Language="C#" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server" >
  
      void Selection_Change(Object sender, EventArgs e)
      {

         // Set the background color for days in the Calendar control
         // based on the value selected by the user from the 
         // DropDownList control.
         Calendar1.DayStyle.BackColor = 
             System.Drawing.Color.FromName(ColorList.SelectedItem.Value);

      }
  
   </script>
  
<head runat="server">
    <title> DropDownList Example </title>
</head>
<body>

   <form id="form1" runat="server">
  
      <h3> DropDownList Example </h3>

      Select a background color for days in the calendar.

      <br /><br /> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br /><br />

      <table cellpadding="5">

         <tr>

            <td>

               Background color:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ColorList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem Selected="True" Value="White"> White </asp:ListItem>
                  <asp:ListItem Value="Silver"> Silver </asp:ListItem>
                  <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem>
                  <asp:ListItem Value="Khaki"> Khaki </asp:ListItem>
                  <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>
  
      </table>
  
   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server" >
  
      Sub Selection_Change(sender As Object, e As EventArgs)

         ' Set the background color for days in the Calendar control
         ' based on the value selected by the user from the
         '  DropDownList control.
         Calendar1.DayStyle.BackColor = _
             System.Drawing.Color.FromName(ColorList.SelectedItem.Value)

      End Sub
  
   </script>
  
<head runat="server">
    <title> DropDownList Example </title>
</head>
<body>

   <form id="form1" runat="server">
  
      <h3> DropDownList Example </h3>

      Select a background color for days in the calendar.

      <br /><br /> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br /><br />

      <table cellpadding="5">

         <tr>

            <td>

               Background color:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ColorList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server">

                  <asp:ListItem Selected="True" Value="White"> White </asp:ListItem>
                  <asp:ListItem Value="Silver"> Silver </asp:ListItem>
                  <asp:ListItem Value="DarkGray"> Dark Gray </asp:ListItem>
                  <asp:ListItem Value="Khaki"> Khaki </asp:ListItem>
                  <asp:ListItem Value="DarkKhaki"> Dark Khaki </asp:ListItem>

               </asp:DropDownList>

            </td>

         </tr>
         
      </table>   
  
   </form>

</body>
</html>

Nell'esempio di codice seguente viene illustrato come creare un controllo tramite data DropDownList binding.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server" >
  
      void Selection_Change(Object sender, EventArgs e)
      {

         // Set the background color for days in the Calendar control
         // based on the value selected by the user from the 
         // DropDownList control.
         Calendar1.DayStyle.BackColor = 
             System.Drawing.Color.FromName(ColorList.SelectedItem.Value);

      }

      void Page_Load(Object sender, EventArgs e)
      {
  
         // Load data for the DropDownList control only once, when the 
         // page is first loaded.
         if(!IsPostBack)
         {

            // Specify the data source and field names for the Text 
            // and Value properties of the items (ListItem objects) 
            // in the DropDownList control.
            ColorList.DataSource = CreateDataSource();
            ColorList.DataTextField = "ColorTextField";
            ColorList.DataValueField = "ColorValueField";

            // Bind the data to the control.
            ColorList.DataBind();

            // Set the default selected item, if desired.
            ColorList.SelectedIndex = 0;

         }

      }

      ICollection CreateDataSource() 
      {
      
         // Create a table to store data for the DropDownList control.
         DataTable dt = new DataTable();
         
         // Define the columns of the table.
         dt.Columns.Add(new DataColumn("ColorTextField", typeof(String)));
         dt.Columns.Add(new DataColumn("ColorValueField", typeof(String)));
 
         // Populate the table with sample values.
         dt.Rows.Add(CreateRow("White", "White", dt));
         dt.Rows.Add(CreateRow("Silver", "Silver", dt));
         dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt));
         dt.Rows.Add(CreateRow("Khaki", "Khaki", dt));
         dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt));
 
         // Create a DataView from the DataTable to act as the data source
         // for the DropDownList control.
         DataView dv = new DataView(dt);
         return dv;

      }

      DataRow CreateRow(String Text, String Value, DataTable dt)
      {

         // Create a DataRow using the DataTable defined in the 
         // CreateDataSource method.
         DataRow dr = dt.NewRow();
 
         // This DataRow contains the ColorTextField and ColorValueField 
         // fields, as defined in the CreateDataSource method. Set the 
         // fields with the appropriate value. Remember that column 0 
         // is defined as ColorTextField, and column 1 is defined as 
         // ColorValueField.
         dr[0] = Text;
         dr[1] = Value;
 
         return dr;

      }
  
   </script>
  
<head runat="server">
    <title> DropDownList Data Binding Example </title>
</head>
<body>

   <form id="form1" runat="server">
  
      <h3> DropDownList Data Binding Example </h3>

      Select a background color for days in the calendar.

      <br /><br /> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br /><br />

      <table cellpadding="5">

         <tr>

            <td>

               Background color:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ColorList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server"/>

            </td>

         </tr>
         
      </table>   
  
   </form>

</body>
</html>

<%@ Page Language="VB" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
   <script runat="server" >
  
      Sub Selection_Change(sender as Object, e As EventArgs)

         ' Set the background color for days in the Calendar control 
         ' based on the value selected by the user from the
         ' DropDownList control.
         Calendar1.DayStyle.BackColor = _
             System.Drawing.Color.FromName(ColorList.SelectedItem.Value)

      End Sub

      Sub Page_Load(sender as Object, e As EventArgs)
  
         ' Load data for the DropDownList control only once, when the 
         ' page is first loaded.
         If Not IsPostBack Then

            ' Specify the data source and field names for the Text 
            ' and Value properties of the items (ListItem objects)
            ' in the DropDownList control.
            ColorList.DataSource = CreateDataSource()
            ColorList.DataTextField = "ColorTextField"
            ColorList.DataValueField = "ColorValueField"

            ' Bind the data to the control.
            ColorList.DataBind()

            ' Set the default selected item, if desired.
            ColorList.SelectedIndex = 0

         End If

      End Sub

      Function CreateDataSource() As ICollection 
      
         ' Create a table to store data for the DropDownList control.
         Dim dt As DataTable = New DataTable()
         
         ' Define the columns of the table.
         dt.Columns.Add(new DataColumn("ColorTextField", GetType(String)))
         dt.Columns.Add(new DataColumn("ColorValueField", GetType(String)))
 
         ' Populate the table with sample values.
         dt.Rows.Add(CreateRow("White", "White", dt))
         dt.Rows.Add(CreateRow("Silver", "Silver", dt))
         dt.Rows.Add(CreateRow("Dark Gray", "DarkGray", dt))
         dt.Rows.Add(CreateRow("Khaki", "Khaki", dt))
         dt.Rows.Add(CreateRow("Dark Khaki", "DarkKhaki", dt))
 
         ' Create a DataView from the DataTable to act as the data source
         ' for the DropDownList control.
         Dim dv As DataView = New DataView(dt)
         Return dv

      End Function

      Function CreateRow(Text As String, Value As String, dt As DataTable) As DataRow 

         ' Create a DataRow using the DataTable defined in the 
         ' CreateDataSource method.
         Dim dr As DataRow = dt.NewRow()
 
         ' This DataRow contains the ColorTextField and ColorValueField 
         ' fields, as defined in the CreateDataSource method. Set the 
         ' fields with the appropriate value. Remember that column 0 
         ' is defined as ColorTextField, and column 1 is defined as 
         ' ColorValueField.
         dr(0) = Text
         dr(1) = Value
 
         Return dr

      End Function
  
   </script>
  
<head runat="server">
    <title> DropDownList Data Binding Example </title>
</head>
<body>

   <form id="form1" runat="server">
  
      <h3> DropDownList Data Binding Example </h3>

      Select a background color for days in the calendar.

      <br /><br /> 
  
      <asp:Calendar id="Calendar1"
           ShowGridLines="True" 
           ShowTitle="True"
           runat="server"/>

      <br /><br />

      <table cellpadding="5">

         <tr>

            <td>

               Background color:

            </td>

         </tr>

         <tr>

            <td>

               <asp:DropDownList id="ColorList"
                    AutoPostBack="True"
                    OnSelectedIndexChanged="Selection_Change"
                    runat="server"/>

            </td>

         </tr>
         
      </table>   
  
   </form>

</body>
</html>

Commenti

Contenuto dell'articolo:

Introduzione
Accessibilità
Sintassi dichiarativa

Introduzione

Utilizzare il DropDownList controllo per creare un controllo elenco a discesa a selezione singola. È possibile controllare l'aspetto del DropDownList controllo impostando le BorderColorproprietà , BorderStylee BorderWidth .

Per specificare gli elementi che si desidera visualizzare nel DropDownList controllo, posizionare un ListItem oggetto per ogni voce tra i tag di apertura e chiusura del DropDownList controllo.

Il controllo supporta anche il DropDownList data binding. Per associare il controllo a un'origine dati, creare un'origine dati, ad esempio un System.Collections.ArrayList oggetto , contenente gli elementi da visualizzare nel controllo . Usare quindi il Control.DataBind metodo per associare l'origine dati al DropDownList controllo .

Utilizzare la SelectedIndex proprietà per determinare a livello di codice l'indice dell'elemento selezionato dall'utente dal DropDownList controllo . L'indice può quindi essere utilizzato per recuperare l'elemento selezionato dall'insieme Items del controllo .

Accessibilità

Per informazioni su come configurare questo controllo in modo che generi markup conforme agli standard di accessibilità, vedere Accessibilità in Visual Studio e ASP.NET e controlli ASP.NET e accessibilità.

Sintassi dichiarativa

<asp:DropDownList
    AccessKey="string"
    AppendDataBoundItems="True|False"
    AutoPostBack="True|False"
    BackColor="color name|#dddddd"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    CausesValidation="True|False"
    CssClass="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DataTextField="string"
    DataTextFormatString="string"
    DataValueField="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    ForeColor="color name|#dddddd"
    Height="size"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnLoad="Load event handler"
    OnPreRender="PreRender event handler"
    OnSelectedIndexChanged="SelectedIndexChanged event handler"
    OnTextChanged="TextChanged event handler"
    OnUnload="Unload event handler"
    runat="server"
    SelectedIndex="integer"
    SelectedValue="string"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    ValidationGroup="string"
    Visible="True|False"
    Width="size"
>
            <asp:ListItem
                Enabled="True|False"
                Selected="True|False"
                Text="string"
                Value="string"
            />
</asp:DropDownList>

Costruttori

Nome	Descrizione
DropDownList()	Inizializza una nuova istanza della classe DropDownList.

Proprietà

Nome	Descrizione
AccessKey	Ottiene o imposta la chiave di accesso che consente di passare rapidamente al controllo server Web. (Ereditato da WebControl)
Adapter	Ottiene l'adattatore specifico del browser per il controllo . (Ereditato da Control)
AppendDataBoundItems	Ottiene o imposta un valore che indica se gli elementi dell'elenco vengono cancellati prima del data binding. (Ereditato da ListControl)
AppRelativeTemplateSourceDirectory	Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl che contiene questo controllo. (Ereditato da Control)
Attributes	Ottiene la raccolta di attributi arbitrari (solo per il rendering) che non corrispondono alle proprietà del controllo. (Ereditato da WebControl)
AutoPostBack	Ottiene o imposta un valore che indica se un postback al server si verifica automaticamente quando l'utente modifica la selezione dell'elenco. (Ereditato da ListControl)
BackColor	Ottiene o imposta il colore di sfondo del controllo server Web. (Ereditato da WebControl)
BindingContainer	Ottiene il controllo che contiene il data binding di questo controllo. (Ereditato da Control)
BorderColor	Ottiene o imposta il colore del bordo del controllo.
BorderStyle	Ottiene o imposta lo stile del bordo del controllo.
BorderWidth	Ottiene o imposta la larghezza del bordo per il controllo .
CausesValidation	Ottiene o imposta un valore che indica se viene eseguita la convalida quando si fa clic su un controllo derivato dalla ListControl classe . (Ereditato da ListControl)
ChildControlsCreated	Ottiene un valore che indica se sono stati creati i controlli figlio del controllo server. (Ereditato da Control)
ClientID	Ottiene l'ID di controllo per il markup HTML generato da ASP.NET. (Ereditato da Control)
ClientIDMode	Ottiene o imposta l'algoritmo utilizzato per generare il valore della ClientID proprietà . (Ereditato da Control)
ClientIDSeparator	Ottiene un valore di carattere che rappresenta il carattere separatore utilizzato nella ClientID proprietà . (Ereditato da Control)
Context	Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente. (Ereditato da Control)
Controls	Ottiene un ControlCollection oggetto che rappresenta i controlli figlio per un controllo server specificato nella gerarchia dell'interfaccia utente. (Ereditato da Control)
ControlStyle	Ottiene lo stile del controllo server Web. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ControlStyleCreated	Ottiene un valore che indica se è stato creato un Style oggetto per la ControlStyle proprietà . Questa proprietà viene usata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CssClass	Ottiene o imposta la classe CSS (Cascading Style Sheet) sottoposta a rendering dal controllo server Web nel client. (Ereditato da WebControl)
DataItemContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataItemContainer. (Ereditato da Control)
DataKeysContainer	Ottiene un riferimento al contenitore di denominazione se il contenitore di denominazione implementa IDataKeysControl. (Ereditato da Control)
DataMember	Ottiene o imposta la tabella specifica nell'oggetto DataSource da associare al controllo . (Ereditato da ListControl)
DataSource	Ottiene o imposta l'origine dati che popola gli elementi del controllo elenco. (Ereditato da ListControl)
DataSourceID	Ottiene o imposta l'ID del controllo da cui il controllo associato a dati recupera il relativo elenco di elementi di dati. (Ereditato da DataBoundControl)
DataSourceObject	Ottiene un oggetto che implementa l'interfaccia IDataSource , che fornisce l'accesso al contenuto dei dati dell'oggetto. (Ereditato da DataBoundControl)
DataTextField	Ottiene o imposta il campo dell'origine dati che fornisce il contenuto di testo delle voci dell'elenco. (Ereditato da ListControl)
DataTextFormatString	Ottiene o imposta la stringa di formattazione utilizzata per controllare la modalità di visualizzazione dei dati associati al controllo elenco. (Ereditato da ListControl)
DataValueField	Ottiene o imposta il campo dell'origine dati che fornisce il valore di ogni elemento dell'elenco. (Ereditato da ListControl)
DesignMode	Ottiene un valore che indica se un controllo viene utilizzato in un'area di progettazione. (Ereditato da Control)
Enabled	Ottiene o imposta un valore che indica se il controllo server Web è abilitato. (Ereditato da WebControl)
EnableTheming	Ottiene o imposta un valore che indica se i temi si applicano a questo controllo. (Ereditato da WebControl)
EnableViewState	Ottiene o imposta un valore che indica se il controllo server mantiene lo stato di visualizzazione e lo stato di visualizzazione di tutti i controlli figlio contenuti, al client richiedente. (Ereditato da Control)
Events	Ottiene un elenco di delegati del gestore eventi per il controllo . Questa proprietà è di sola lettura. (Ereditato da Control)
Font	Ottiene le proprietà del tipo di carattere associate al controllo server Web. (Ereditato da WebControl)
ForeColor	Ottiene o imposta il colore di primo piano (in genere il colore del testo) del controllo server Web. (Ereditato da WebControl)
HasAttributes	Ottiene un valore che indica se il controllo dispone di attributi impostati. (Ereditato da WebControl)
HasChildViewState	Ottiene un valore che indica se i controlli figlio del controllo server corrente hanno impostazioni dello stato di visualizzazione salvate. (Ereditato da Control)
Height	Ottiene o imposta l'altezza del controllo server Web. (Ereditato da WebControl)
ID	Ottiene o imposta l'identificatore programmatico assegnato al controllo server. (Ereditato da Control)
IdSeparator	Ottiene il carattere utilizzato per separare gli identificatori di controllo. (Ereditato da Control)
Initialized	Ottiene un valore che indica se il controllo associato a dati è stato inizializzato. (Ereditato da BaseDataBoundControl)
IsBoundUsingDataSourceID	Ottiene un valore che indica se la DataSourceID proprietà è impostata. (Ereditato da BaseDataBoundControl)
IsChildControlStateCleared	Ottiene un valore che indica se i controlli contenuti all'interno di questo controllo hanno uno stato di controllo. (Ereditato da Control)
IsDataBindingAutomatic	Ottiene un valore che indica se il data binding è automatico. (Ereditato da BaseDataBoundControl)
IsEnabled	Ottiene un valore che indica se il controllo è abilitato. (Ereditato da WebControl)
IsTrackingViewState	Ottiene un valore che indica se il controllo server salva le modifiche apportate allo stato di visualizzazione. (Ereditato da Control)
IsUsingModelBinders	Ottiene un valore che indica se l'associazione di modelli è in uso. (Ereditato da DataBoundControl)
IsViewStateEnabled	Ottiene un valore che indica se lo stato di visualizzazione è abilitato per questo controllo. (Ereditato da Control)
Items	Ottiene l'insieme di elementi nel controllo elenco. (Ereditato da ListControl)
ItemType	Ottiene o imposta il nome del tipo di elemento di dati per il data binding fortemente tipizzato. (Ereditato da DataBoundControl)
LoadViewStateByID	Ottiene un valore che indica se il controllo partecipa al caricamento dello stato di visualizzazione in ID base al posto dell'indice. (Ereditato da Control)
NamingContainer	Ottiene un riferimento al contenitore di denominazione del controllo server, che crea uno spazio dei nomi univoco per la differenziazione tra i controlli server con lo stesso ID valore della proprietà. (Ereditato da Control)
Page	Ottiene un riferimento all'istanza Page che contiene il controllo server. (Ereditato da Control)
Parent	Ottiene un riferimento al controllo padre del controllo server nella gerarchia dei controlli pagina. (Ereditato da Control)
RenderingCompatibility	Ottiene un valore che specifica la versione ASP.NET con cui è stato eseguito il rendering del codice HTML sarà compatibile. (Ereditato da Control)
RequiresDataBinding	Ottiene o imposta un valore che indica se il DataBind() metodo deve essere chiamato. (Ereditato da BaseDataBoundControl)
SelectArguments	Ottiene un DataSourceSelectArguments oggetto utilizzato dal controllo associato a dati durante il recupero di dati da un controllo origine dati. (Ereditato da DataBoundControl)
SelectedIndex	Ottiene o imposta l'indice dell'elemento selezionato nel DropDownList controllo .
SelectedItem	Ottiene l'elemento selezionato con l'indice più basso nel controllo elenco. (Ereditato da ListControl)
SelectedValue	Ottiene il valore dell'elemento selezionato nel controllo elenco oppure seleziona l'elemento nel controllo elenco che contiene il valore specificato. (Ereditato da ListControl)
SelectMethod	Nome del metodo da chiamare per leggere i dati. (Ereditato da DataBoundControl)
Site	Ottiene informazioni sul contenitore che ospita il controllo corrente durante il rendering in un'area di progettazione. (Ereditato da Control)
SkinID	Ottiene o imposta l'interfaccia da applicare al controllo. (Ereditato da WebControl)
Style	Ottiene una raccolta di attributi di testo di cui verrà eseguito il rendering come attributo di stile sul tag esterno del controllo server Web. (Ereditato da WebControl)
SupportsDisabledAttribute	Ottiene un valore che indica se il controllo deve impostare l'attributo dell'elemento `disabled` HTML sottoposto a rendering su "disabled" quando la proprietà del IsEnabled controllo è `false`.
TabIndex	Ottiene o imposta l'indice della scheda del controllo server Web. (Ereditato da WebControl)
TagKey	Ottiene il HtmlTextWriterTag valore per il ListControl controllo . (Ereditato da ListControl)
TagName	Ottiene il nome del tag di controllo. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
TemplateControl	Ottiene o imposta un riferimento al modello che contiene questo controllo. (Ereditato da Control)
TemplateSourceDirectory	Ottiene la directory virtuale dell'oggetto Page o UserControl che contiene il controllo server corrente. (Ereditato da Control)
Text	Ottiene o imposta la SelectedValue proprietà del ListControl controllo . (Ereditato da ListControl)
ToolTip	Ottiene o imposta il testo della descrizione comando visualizzato quando il puntatore del mouse si posiziona sul controllo.
ToolTip	Ottiene o imposta il testo visualizzato quando il puntatore del mouse passa il mouse sul controllo server Web. (Ereditato da WebControl)
UniqueID	Ottiene l'identificatore univoco e qualificato gerarchicamente per il controllo server. (Ereditato da Control)
ValidateRequestMode	Ottiene o imposta un valore che indica se il controllo controlla l'input client dal browser per individuare valori potenzialmente pericolosi. (Ereditato da Control)
ValidationGroup	Ottiene o imposta il gruppo di controlli per cui il controllo derivato dalla classe determina la ListControl convalida quando esegue il postback al server. (Ereditato da ListControl)
ViewState	Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un controllo server tra più richieste per la stessa pagina. (Ereditato da Control)
ViewStateIgnoresCase	Ottiene un valore che indica se l'oggetto StateBag non fa distinzione tra maiuscole e minuscole. (Ereditato da Control)
ViewStateMode	Ottiene o imposta la modalità dello stato di visualizzazione di questo controllo. (Ereditato da Control)
Visible	Ottiene o imposta un valore che indica se il rendering di un controllo server viene eseguito come interfaccia utente nella pagina. (Ereditato da Control)
Width	Ottiene o imposta la larghezza del controllo server Web. (Ereditato da WebControl)

Metodi

Nome	Descrizione
AddAttributesToRender(HtmlTextWriter)	Aggiunge attributi e stili HTML di cui è necessario eseguire il rendering all'oggetto specificato HtmlTextWriter .
AddedControl(Control, Int32)	Chiamato dopo l'aggiunta di un controllo figlio all'insieme Controls dell'oggetto Control . (Ereditato da Control)
AddParsedSubObject(Object)	Notifica al controllo server che un elemento, XML o HTML, è stato analizzato e aggiunge l'elemento all'oggetto del ControlCollection controllo server. (Ereditato da Control)
ApplyStyle(Style)	Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, sovrascrivendo tutti gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ApplyStyleSheetSkin(Page)	Applica le proprietà di stile definite nel foglio di stile della pagina al controllo . (Ereditato da Control)
BeginRenderTracing(TextWriter, Object)	Inizia la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
BuildProfileTree(String, Boolean)	Raccoglie informazioni sul controllo server e le distribuisce alla Trace proprietà da visualizzare quando la traccia è abilitata per la pagina. (Ereditato da Control)
ClearCachedClientID()	Imposta il valore memorizzato nella ClientID cache su `null`. (Ereditato da Control)
ClearChildControlState()	Elimina le informazioni sullo stato del controllo per i controlli figlio del controllo server. (Ereditato da Control)
ClearChildState()	Elimina le informazioni sullo stato di visualizzazione e sullo stato del controllo per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearChildViewState()	Elimina le informazioni sullo stato di visualizzazione per tutti i controlli figlio del controllo server. (Ereditato da Control)
ClearEffectiveClientIDMode()	Imposta la ClientIDMode proprietà dell'istanza del controllo corrente e di tutti i controlli figlio su Inherit. (Ereditato da Control)
ClearSelection()	Cancella la selezione dell'elenco e imposta la Selected proprietà di tutti gli elementi su false. (Ereditato da ListControl)
ConfirmInitState()	Imposta lo stato inizializzato del controllo associato a dati. (Ereditato da BaseDataBoundControl)
CopyBaseAttributes(WebControl)	Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web da cui viene chiamato questo metodo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CreateChildControls()	Chiamato dal framework di pagina ASP.NET per notificare ai controlli server che usano l'implementazione basata sulla composizione per creare tutti i controlli figlio che contengono in preparazione alla registrazione o al rendering. (Ereditato da Control)
CreateControlCollection()	Crea una raccolta per archiviare i controlli figlio.
CreateControlStyle()	Crea l'oggetto stile utilizzato internamente dalla WebControl classe per implementare tutte le proprietà correlate allo stile. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
CreateDataSourceSelectArguments()	Crea un oggetto predefinito DataSourceSelectArguments utilizzato dal controllo associato a dati se non vengono specificati argomenti. (Ereditato da DataBoundControl)
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da Control)
DataBind()	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio. (Ereditato da BaseDataBoundControl)
DataBind(Boolean)	Associa un'origine dati al controllo server richiamato e a tutti i relativi controlli figlio con un'opzione per generare l'evento DataBinding . (Ereditato da Control)
DataBindChildren()	Associa un'origine dati ai controlli figlio del controllo server. (Ereditato da Control)
Dispose()	Consente a un controllo server di eseguire la pulizia finale prima che venga rilasciata dalla memoria. (Ereditato da Control)
EndRenderTracing(TextWriter, Object)	Termina la traccia in fase di progettazione dei dati di rendering. (Ereditato da Control)
EnsureChildControls()	Determina se il controllo server contiene controlli figlio. In caso contrario, crea controlli figlio. (Ereditato da Control)
EnsureDataBound()	Chiama il DataBind() metodo se la DataSourceID proprietà è impostata e il controllo associato a dati è contrassegnato per richiedere l'associazione. (Ereditato da BaseDataBoundControl)
EnsureID()	Crea un identificatore per i controlli a cui non è assegnato un identificatore. (Ereditato da Control)
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
FindControl(String, Int32)	Cerca nel contenitore di denominazione corrente un controllo server con l'oggetto specificato `id` e un numero intero, specificato nel `pathOffset` parametro , che facilita la ricerca. Non è consigliabile eseguire l'override di questa versione del FindControl metodo . (Ereditato da Control)
FindControl(String)	Cerca nel contenitore di denominazione corrente un controllo server con il parametro specificato `id` . (Ereditato da Control)
Focus()	Imposta lo stato attivo dell'input su un controllo . (Ereditato da Control)
GetData()	Recupera un DataSourceView oggetto utilizzato dal controllo associato a dati per eseguire operazioni sui dati. (Ereditato da DataBoundControl)
GetDataSource()	Recupera l'interfaccia IDataSource a cui è associato il controllo associato a dati, se presente. (Ereditato da DataBoundControl)
GetDesignModeState()	Ottiene i dati in fase di progettazione per un controllo . (Ereditato da Control)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetRouteUrl(Object)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route. (Ereditato da Control)
GetRouteUrl(String, Object)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)	Ottiene l'URL che corrisponde a un set di parametri di route e un nome di route. (Ereditato da Control)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
GetUniqueIDRelativeTo(Control)	Restituisce la parte con prefisso della UniqueID proprietà del controllo specificato. (Ereditato da Control)
HasControls()	Determina se il controllo server contiene controlli figlio. (Ereditato da Control)
HasEvents()	Restituisce un valore che indica se gli eventi vengono registrati per il controllo o per i controlli figlio. (Ereditato da Control)
IsLiteralContent()	Determina se il controllo server contiene solo contenuto letterale. (Ereditato da Control)
LoadControlState(Object)	Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal SaveControlState() metodo . (Ereditato da Control)
LoadPostData(String, NameValueCollection)	Elabora i dati di postback per il DropDownList controllo.
LoadViewState(Object)	Carica lo stato di visualizzazione salvato in precedenza del DetailsView controllo. (Ereditato da ListControl)
MapPathSecure(String)	Recupera il percorso fisico a cui viene mappato un percorso virtuale, assoluto o relativo. (Ereditato da Control)
MarkAsDataBound()	Imposta lo stato del controllo nello stato di visualizzazione come associato correttamente ai dati. (Ereditato da DataBoundControl)
MemberwiseClone()	Crea una copia superficiale dell'oggetto corrente Object. (Ereditato da Object)
MergeStyle(Style)	Copia tutti gli elementi non in blocchi dello stile specificato nel controllo Web, ma non sovrascriverà gli elementi di stile esistenti del controllo. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)	Determina se l'evento per il controllo server viene passato alla gerarchia di controllo server dell'interfaccia utente della pagina. (Ereditato da Control)
OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)	Genera l'evento CreatingModelDataSource. (Ereditato da DataBoundControl)
OnDataBinding(EventArgs)	Genera l'evento DataBinding. (Ereditato da ListControl)
OnDataBound(EventArgs)	Genera l'evento DataBound. (Ereditato da BaseDataBoundControl)
OnDataPropertyChanged()	Riassocia il controllo associato a dati ai dati dopo la modifica di una delle proprietà di identificazione dell'origine dati di base. (Ereditato da DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)	Genera l'evento DataSourceViewChanged. (Ereditato da DataBoundControl)
OnInit(EventArgs)	Genera l'evento Init. (Ereditato da Control)
OnInit(EventArgs)	Gestisce l'evento Init . (Ereditato da BaseDataBoundControl)
OnLoad(EventArgs)	Genera l'evento Load. (Ereditato da Control)
OnLoad(EventArgs)	Gestisce l'evento Load . (Ereditato da DataBoundControl)
OnPagePreLoad(Object, EventArgs)	Imposta lo stato inizializzato del controllo associato a dati prima del caricamento del controllo. (Ereditato da DataBoundControl)
OnPreRender(EventArgs)	Genera l'evento PreRender. (Ereditato da ListControl)
OnSelectedIndexChanged(EventArgs)	Genera l'evento SelectedIndexChanged. In questo modo è possibile fornire un gestore personalizzato per l'evento. (Ereditato da ListControl)
OnTextChanged(EventArgs)	Genera l'evento TextChanged. (Ereditato da ListControl)
OnUnload(EventArgs)	Genera l'evento Unload. (Ereditato da Control)
OpenFile(String)	Ottiene un Stream oggetto utilizzato per leggere un file. (Ereditato da Control)
PerformDataBinding(IEnumerable)	Associa l'origine dati specificata al controllo derivato dalla ListControl classe . (Ereditato da ListControl)
PerformSelect()	Recupera i dati dall'origine dati associata. (Ereditato da ListControl)
RaiseBubbleEvent(Object, EventArgs)	Assegna tutte le origini dell'evento e le relative informazioni all'elemento padre del controllo. (Ereditato da Control)
RaisePostDataChangedEvent()	Genera eventi per il controllo quando si verifica il DropDownList postback.
RemovedControl(Control)	Chiamato dopo che un controllo figlio viene rimosso dall'insieme Controls dell'oggetto Control . (Ereditato da Control)
Render(HtmlTextWriter)	Esegue il rendering del controllo nel writer HTML specificato. (Ereditato da WebControl)
RenderBeginTag(HtmlTextWriter)	Esegue il rendering del tag di apertura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
RenderChildren(HtmlTextWriter)	Restituisce il contenuto degli elementi figlio di un controllo server in un oggetto fornito HtmlTextWriter , che scrive il contenuto di cui eseguire il rendering nel client. (Ereditato da Control)
RenderContents(HtmlTextWriter)	Esegue il rendering del contenuto del controllo nel writer specificato.
RenderContents(HtmlTextWriter)	Esegue il rendering degli elementi nel ListControl controllo . (Ereditato da ListControl)
RenderControl(HtmlTextWriter, ControlAdapter)	Restituisce il contenuto del controllo server a un oggetto fornito HtmlTextWriter utilizzando un oggetto fornito ControlAdapter . (Ereditato da Control)
RenderControl(HtmlTextWriter)	Restituisce il contenuto del controllo server in un oggetto fornito HtmlTextWriter e archivia le informazioni di traccia sul controllo se la traccia è abilitata. (Ereditato da Control)
RenderEndTag(HtmlTextWriter)	Esegue il rendering del tag di chiusura HTML del controllo nel writer specificato. Questo metodo viene usato principalmente dagli sviluppatori di controlli. (Ereditato da WebControl)
ResolveAdapter()	Ottiene l'adattatore di controllo responsabile del rendering del controllo specificato. (Ereditato da Control)
ResolveClientUrl(String)	Ottiene un URL che può essere utilizzato dal browser. (Ereditato da Control)
ResolveUrl(String)	Converte un URL in un URL utilizzabile nel client richiedente. (Ereditato da Control)
SaveControlState()	Salva le modifiche apportate allo stato del controllo server dopo il postback della pagina al server. (Ereditato da Control)
SaveViewState()	Salva lo stato di visualizzazione corrente del ListControl controllo -derived e gli elementi in esso contenuti. (Ereditato da ListControl)
SetDesignModeState(IDictionary)	Imposta i dati in fase di progettazione per un controllo . (Ereditato da Control)
SetPostDataSelection(Int32)	Imposta la Selected proprietà di un ListItem controllo dopo la pubblicazione di una pagina. (Ereditato da ListControl)
SetRenderMethodDelegate(RenderMethod)	Assegna un delegato del gestore eventi per eseguire il rendering del controllo server e del relativo contenuto nel controllo padre. (Ereditato da Control)
SetTraceData(Object, Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando l'oggetto tracciato, la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
SetTraceData(Object, Object)	Imposta i dati di traccia per la traccia in fase di progettazione dei dati di rendering, usando la chiave dei dati di traccia e il valore dei dati di traccia. (Ereditato da Control)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
TrackViewState()	Contrassegna il punto iniziale per iniziare a tenere traccia e salvare le modifiche dello stato di visualizzazione in un ListControl controllo -derived. (Ereditato da ListControl)
ValidateDataSource(Object)	Verifica che l'oggetto a cui è associato un controllo associato a dati sia utilizzabile. (Ereditato da DataBoundControl)
VerifyMultiSelect()	Genera sempre un'eccezione HttpException perché la selezione multipla non è supportata per il DropDownList controllo .

Eventi

Nome	Descrizione
CallingDataMethods	Si verifica quando vengono chiamati i metodi di dati. (Ereditato da DataBoundControl)
CreatingModelDataSource	Si verifica quando l'oggetto ModelDataSource viene creato. (Ereditato da DataBoundControl)
DataBinding	Si verifica quando il controllo server viene associato a un'origine dati. (Ereditato da Control)
DataBound	Si verifica dopo l'associazione del controllo server a un'origine dati. (Ereditato da BaseDataBoundControl)
Disposed	Si verifica quando viene rilasciato un controllo server dalla memoria, ovvero l'ultima fase del ciclo di vita del controllo server quando viene richiesta una pagina ASP.NET. (Ereditato da Control)
Init	Si verifica quando il controllo server viene inizializzato, ovvero il primo passaggio del ciclo di vita. (Ereditato da Control)
Load	Si verifica quando il controllo server viene caricato nell'oggetto Page . (Ereditato da Control)
PreRender	Si verifica dopo il caricamento dell'oggetto Control , ma prima del rendering. (Ereditato da Control)
SelectedIndexChanged	Si verifica quando la selezione dal controllo elenco cambia tra i post nel server. (Ereditato da ListControl)
TextChanged	Si verifica quando le Text proprietà e SelectedValue cambiano. (Ereditato da ListControl)
Unload	Si verifica quando il controllo server viene scaricato dalla memoria. (Ereditato da Control)

Implementazioni dell'interfaccia esplicita

Nome	Descrizione
IAttributeAccessor.GetAttribute(String)	Ottiene un attributo del controllo Web con il nome specificato. (Ereditato da WebControl)
IAttributeAccessor.SetAttribute(String, String)	Imposta un attributo del controllo Web sul nome e sul valore specificati. (Ereditato da WebControl)
IControlBuilderAccessor.ControlBuilder	Per una descrizione di questo membro, vedere ControlBuilder. (Ereditato da Control)
IControlDesignerAccessor.GetDesignModeState()	Per una descrizione di questo membro, vedere GetDesignModeState(). (Ereditato da Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Per una descrizione di questo membro, vedere SetDesignModeState(IDictionary). (Ereditato da Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Per una descrizione di questo membro, vedere SetOwnerControl(Control). (Ereditato da Control)
IControlDesignerAccessor.UserData	Per una descrizione di questo membro, vedere UserData. (Ereditato da Control)
IDataBindingsAccessor.DataBindings	Per una descrizione di questo membro, vedere DataBindings. (Ereditato da Control)
IDataBindingsAccessor.HasDataBindings	Per una descrizione di questo membro, vedere HasDataBindings. (Ereditato da Control)
IExpressionsAccessor.Expressions	Per una descrizione di questo membro, vedere Expressions. (Ereditato da Control)
IExpressionsAccessor.HasExpressions	Per una descrizione di questo membro, vedere HasExpressions. (Ereditato da Control)
IParserAccessor.AddParsedSubObject(Object)	Per una descrizione di questo membro, vedere AddParsedSubObject(Object). (Ereditato da Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Elabora i dati pubblicati per il DropDownList controllo.
IPostBackDataHandler.RaisePostDataChangedEvent()	Genera eventi per il DropDownList controllo sul postback.

Metodi di estensione

Nome	Descrizione
EnablePersistedSelection(BaseDataBoundControl)	Obsoleti. Consente di rendere persistente la selezione nei controlli dati che supportano la selezione e il paging.
FindDataSourceControl(Control)	Restituisce l'origine dati associata al controllo dati per il controllo specificato.
FindFieldTemplate(Control, String)	Restituisce il modello di campo per la colonna specificata nel contenitore di denominazione del controllo specificato.
FindMetaTable(Control)	Restituisce l'oggetto metatable per il controllo dati contenitore.

Si applica a

Vedi anche

Commenti e suggerimenti

Questa pagina è stata utile?