CheckBoxList Classe

Definizione

Definisce un gruppo di caselle di controllo a selezione multipla che può essere creato dinamicamente associando il controllo a una origine dati.

public ref class CheckBoxList : System::Web::UI::WebControls::ListControl, System::Web::UI::INamingContainer, System::Web::UI::IPostBackDataHandler, System::Web::UI::WebControls::IRepeatInfoUser
public class CheckBoxList : System.Web.UI.WebControls.ListControl, System.Web.UI.INamingContainer, System.Web.UI.IPostBackDataHandler, System.Web.UI.WebControls.IRepeatInfoUser
type CheckBoxList = class
    inherit ListControl
    interface IRepeatInfoUser
    interface INamingContainer
    interface IPostBackDataHandler
Public Class CheckBoxList
Inherits ListControl
Implements INamingContainer, IPostBackDataHandler, IRepeatInfoUser
Ereditarietà
Ereditarietà
Implementazioni

Esempio

Per accompagnare questo argomento, è disponibile un progetto di sito Web di Visual Studio con codice sorgente.

Nell'esempio di codice seguente viene illustrato come creare un CheckBoxList controllo in una pagina Web.

Nota

L'esempio di codice seguente usa il modello di codice a file singolo e potrebbe non funzionare correttamente se copiato direttamente in un file code-behind. Questo esempio di codice deve essere copiato in un file di testo vuoto con un'estensione .aspx. Per altre informazioni sul modello di codice Web Forms, vedere ASP.NET modello di codice della pagina Web Forms.


<%@ 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" >

<head runat="server">
    <title> CheckBoxList Example </title>
<script runat="server">

      void Check_Clicked(Object sender, EventArgs e) 
      {

         Message.Text = "Selected Item(s):<br /><br />";

         // Iterate through the Items collection of the CheckBoxList 
         // control and display the selected items.
         for (int i=0; i<checkboxlist1.Items.Count; i++)
         {

            if (checkboxlist1.Items[i].Selected)
            {

               Message.Text += checkboxlist1.Items[i].Text + "<br />";

            }

         }

      }

   </script>
 
</head>

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

      Select items from the CheckBoxList.

      <br /><br />

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           runat="server">
 
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>
 
      </asp:CheckBoxList>
 
      <br /><br />

      <asp:label id="Message" runat="server" AssociatedControlID="checkboxlist1"/>
             
   </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" >

<head runat="server">
    <title> CheckBoxList Example </title>
<script runat="server">

      Sub Check_Clicked(sender as Object, e As EventArgs) 

         Message.Text = "Selected Item(s):<br /><br />"

         ' Iterate through the Items collection of the CheckBoxList
         ' control and display the selected items.
         Dim i As Integer

         For i=0 To checkboxlist1.Items.Count - 1

            If checkboxlist1.Items(i).Selected Then

               Message.Text &= checkboxlist1.Items(i).Text & "<br />"

            End If

         Next

      End Sub

   </script>
 
</head>

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

      Select items from the CheckBoxList.

      <br /><br />

      <asp:CheckBoxList id="checkboxlist1" 
           AutoPostBack="True"
           CellPadding="5"
           CellSpacing="5"
           RepeatColumns="2"
           RepeatDirection="Vertical"
           RepeatLayout="Flow"
           TextAlign="Right"
           OnSelectedIndexChanged="Check_Clicked"
           runat="server">
 
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>
 
      </asp:CheckBoxList>
 
      <br /><br />

      <asp:label id="Message" runat="server" AssociatedControlID="checkboxlist1"/>
             
   </form>
          
</body>

</html>

Commenti

In questo argomento

Introduzione

Il CheckBoxList controllo fornisce un gruppo di caselle di controllo a selezione multipla che può essere generato dinamicamente con data binding. Contiene una Items raccolta con membri corrispondenti a singoli elementi nell'elenco. Per determinare quali elementi vengono controllati, eseguire l'iterazione tramite la raccolta e testare la Selected proprietà di ogni elemento nell'elenco.

Nota

È anche possibile usare più CheckBox controlli. Il CheckBoxList controllo è più semplice per la creazione di un set di caselle di controllo usando il data binding, mentre il singolo CheckBox controllo offre un maggiore controllo sul layout.

Specifica del layout elenco

È possibile specificare il modo in cui viene visualizzato l'elenco usando le RepeatLayout proprietà e RepeatDirection . Per informazioni sulle opzioni di layout, vedere l'enumerazione RepeatLayout .

per impostazione predefinita, la proprietà RepeatDirection è impostata su RepeatDirection.Vertical. Impostando questa proprietà per RepeatDirection.Horizontal eseguire il rendering orizzontale dell'elenco. Alcune RepeatLayout impostazioni non consentono il layout orizzontale. Per altre informazioni, vedere l'enumerazione RepeatLayout.

Specifica degli elementi di elenco

Per specificare gli elementi da visualizzare nel CheckBoxList controllo, inserire un ListItem elemento per ogni voce tra i tag di apertura e chiusura del CheckBoxList controllo.

Il controllo supporta anche il CheckBoxList data binding. Per associare il controllo a un'origine dati, creare prima un'origine dati, ad esempio uno degli DataSourceControl oggetti, che contiene gli elementi da visualizzare nel controllo. Usare quindi il DataBind metodo per associare l'origine dati al CheckBoxList controllo. Utilizzare le DataTextField proprietà e DataValueField per specificare il campo nell'origine dati da associare rispettivamente alle Text proprietà e Value di ogni elemento dell'elenco nel controllo. Il CheckBoxList controllo visualizza ora le informazioni dall'origine dati.

Per determinare gli elementi selezionati nel controllo, eseguire l'iterazione CheckBoxList tramite la Items raccolta e testare la Selected proprietà di ogni elemento nell'insieme.

Attenzione

Questo controllo può essere usato per visualizzare l'input utente, che potrebbe includere script client dannosi. Controllare tutte le informazioni inviate da un client per script eseguibili, istruzioni SQL o altro codice prima di visualizzarlo nell'applicazione. È possibile usare i controlli di convalida per verificare l'input utente prima di visualizzare il testo di input in un controllo. ASP.NET fornisce una funzionalità di convalida della richiesta di input per bloccare lo script e il codice HTML nell'input dell'utente. Per altre informazioni, vedere Protezione dei controlli standard, Procedura: Proteggere dagli exploit di script in un'applicazione Web applicando la codifica HTML alle stringhe e convalidando l'input dell'utente in ASP.NET pagine Web.

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:CheckBoxList  
    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"  
    CellPadding="integer"  
    CellSpacing="integer"  
    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"  
    RepeatColumns="integer"  
    RepeatDirection="Horizontal|Vertical"  
    RepeatLayout="Table|Flow|OrderedList|UnorderedList"  
    runat="server"  
    SelectedIndex="integer"  
    SelectedValue="string"  
    SkinID="string"  
    Style="string"  
    TabIndex="integer"  
    TextAlign="Left|Right"  
    ToolTip="string"  
    ValidationGroup="string"  
    Visible="True|False"  
    Width="size"  
>  
            <asp:ListItem  
                Enabled="True|False"  
                Selected="True|False"  
                Text="string"  
                Value="string"  
            />  
</asp:CheckBoxList>  

Costruttori

CheckBoxList()

Inizializza una nuova istanza della classe CheckBoxList.

Proprietà

AccessKey

Ottiene o imposta il tasto di scelta che consente di accedere 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 sono stati cancellati prima del data binding.

(Ereditato da ListControl)
AppRelativeTemplateSourceDirectory

Ottiene o imposta la directory virtuale relativa all'applicazione dell'oggetto Page o UserControl contenente questo controllo.

(Ereditato da Control)
Attributes

Ottiene l'insieme 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 si verifica un postback automatico al server 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 contenente l'associazione dati del controllo corrente.

(Ereditato da Control)
BorderColor

Ottiene o imposta il colore del bordo del controllo Web.

(Ereditato da WebControl)
BorderStyle

Ottiene o imposta lo stile del bordo del controllo server Web.

(Ereditato da WebControl)
BorderWidth

Ottiene o imposta la larghezza del bordo del controllo server Web.

(Ereditato da WebControl)
CausesValidation

Ottiene o imposta un valore che indica se viene eseguita la convalida quando si fa clic su un controllo derivato dalla classe ListControl.

(Ereditato da ListControl)
CellPadding

Ottiene o imposta la distanza in pixel tra il bordo e il contenuto della cella.

CellSpacing

Ottiene o imposta la distanza in pixel tra le celle.

ChildControlsCreated

Ottiene un valore che indica se i controlli figli del controllo server sono stati creati.

(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 proprietà ClientID.

(Ereditato da Control)
ClientIDSeparator

Ottiene un carattere che rappresenta il separatore utilizzato nella proprietà ClientID.

(Ereditato da Control)
Context

Ottiene l'oggetto HttpContext associato al controllo server per la richiesta Web corrente.

(Ereditato da Control)
Controls

Ottiene un oggetto ControlCollection 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 usata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ControlStyleCreated

Ottiene un valore che indica se è stato creato un oggetto Style per la proprietà ControlStyle. Questa proprietà viene utilizzata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CssClass

Ottiene o imposta la classe CSS (Cascading Style Sheet) di cui viene eseguito il rendering tramite il controllo server Web sul 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 nella proprietà 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 l'elenco di elementi di dati.

(Ereditato da DataBoundControl)
DataSourceObject

Ottiene un oggetto che implementa l'interfaccia IDataSource che fornisce l'accesso al contenuto dati dell'oggetto.

(Ereditato da DataBoundControl)
DataTextField

Ottiene o imposta il campo dell'origine dati che fornisce il contenuto di testo degli elementi dell'elenco.

(Ereditato da ListControl)
DataTextFormatString

Ottiene o imposta la stringa di formattazione usata per controllare il modo in cui vengono visualizzati i dati associati all'elenco.

(Ereditato da ListControl)
DataValueField

Ottiene o imposta il campo dell'origine dati che fornisce il valore di ciascun 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 al controllo vengono applicati i temi.

(Ereditato da WebControl)
EnableViewState

Ottiene o imposta un valore che indica se lo stato di visualizzazione del controllo server deve essere persistente e lo stato di visualizzazione dei controlli figlio contenuti, per il client richiedente.

(Ereditato da Control)
Events

Ottiene un elenco dei delegati del gestore eventi per il controllo. Questa proprietà è di sola lettura.

(Ereditato da Control)
Font

Ottiene le proprietà del 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 sono impostati attributi per il controllo.

(Ereditato da WebControl)
HasChildViewState

Ottiene un valore che indica se per i controlli figlio del controllo server corrente esistono impostazioni dello stato di visualizzazione salvate.

(Ereditato da Control)
HasFooter

Ottiene un valore che indica se il controllo CheckBoxList contiene una sezione di piè di pagina.

HasHeader

Ottiene un valore che indica se il controllo CheckBoxList contiene una sezione di intestazione.

HasSeparators

Ottiene un valore che indica se il controllo CheckBoxList contiene separatori tra gli elementi dell'elenco.

Height

Ottiene o imposta l'altezza del controllo server Web.

(Ereditato da WebControl)
ID

Ottiene o imposta l'identificatore a livello di codice 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 con associazione a dati è stato inizializzato.

(Ereditato da BaseDataBoundControl)
IsBoundUsingDataSourceID

Ottiene un valore che indica se la proprietà DataSourceID è impostata.

(Ereditato da BaseDataBoundControl)
IsChildControlStateCleared

Ottiene un valore che indica se i controlli contenuti in questo controllo dispongono di informazioni sullo stato del controllo.

(Ereditato da Control)
IsDataBindingAutomatic

Ottiene un valore che indica se l'associazione dati è automatica.

(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 allo stato di visualizzazione.

(Ereditato da Control)
IsUsingModelBinders

Ottiene un valore che indica se l'associazione del modello è in uso.

(Ereditato da DataBoundControl)
IsViewStateEnabled

Ottiene un valore che indica se lo stato di visualizzazione è attivato per il controllo corrente.

(Ereditato da Control)
Items

Ottiene la raccolta di elementi nell'elenco.

(Ereditato da ListControl)
ItemType

Ottiene o imposta il nome del tipo di elemento dati per l'associazione dati fortemente tipizzata.

(Ereditato da DataBoundControl)
LoadViewStateByID

Ottiene un valore che indica se il controllo prende parte al caricamento del proprio stato di visualizzazione tramite ID anziché tramite l'indice.

(Ereditato da Control)
NamingContainer

Ottiene un riferimento al contenitore dei nomi del controllo server, che crea uno spazio dei nomi univoco per distinguere i controlli server che hanno lo stesso valore della proprietà ID.

(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 della pagina.

(Ereditato da Control)
RenderingCompatibility

Ottiene un valore che specifica la versione di ASP.NET con cui sarà compatibile il codice HTML di cui è stato eseguito il rendering.

(Ereditato da Control)
RenderWhenDataEmpty

Ottiene o imposta un valore che indica se viene eseguito il rendering del controllo quando l'origine dati non contiene dati o il controllo non è associato a dati.

RepeatColumns

Ottiene o imposta il numero di colonne da visualizzare nel controllo CheckBoxList.

RepeatDirection

Ottiene o imposta un valore che indica se il controllo viene visualizzato verticalmente o orizzontalmente.

RepeatedItemCount

Ottiene il numero di elementi dell'elenco nel controllo CheckBoxList.

RepeatLayout

Ottiene o imposta un valore che specifica se il rendering dell'elenco verrà eseguito usando un elemento table, un elemento ul, un elemento ol o un elemento span.

RequiresDataBinding

Ottiene o imposta un valore che indica se deve essere chiamato il metodo DataBind().

(Ereditato da BaseDataBoundControl)
SelectArguments

Ottiene un oggetto DataSourceSelectArguments che il controllo con associazione a dati utilizza al momento del recupero dei dati da un controllo origine dati.

(Ereditato da DataBoundControl)
SelectedIndex

Ottiene o imposta l'indice ordinale più basso degli elementi selezionati nell'elenco.

(Ereditato da ListControl)
SelectedItem

Ottiene l'elemento selezionato con l'indice più basso nell'elenco.

(Ereditato da ListControl)
SelectedValue

Ottiene il valore dell'elemento selezionato nell'elenco o seleziona l'elemento nell'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 del controllo corrente quando viene eseguito il rendering in un'area di progettazione.

(Ereditato da Control)
SkinID

Ottiene o imposta l'interfaccia personalizzata da applicare al controllo.

(Ereditato da WebControl)
Style

Ottiene un insieme di attributi di testo di cui verrà eseguito il rendering sotto forma di attributo di stile nel tag esterno del controllo server Web.

(Ereditato da WebControl)
SupportsDisabledAttribute

Ottiene un valore che indica se il controllo deve impostare l'attributo disabled dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è false.

(Ereditato da WebControl)
SupportsDisabledAttribute

Ottiene un valore che indica se il controllo deve impostare l'attributo disabled dell'elemento HTML di cui è stato eseguito il rendering su "disabilitato" quando la proprietà IsEnabled del controllo è false.

(Ereditato da BaseDataBoundControl)
TabIndex

Ottiene o imposta l'indice di tabulazione del controllo server Web.

(Ereditato da WebControl)
TagKey

Ottiene il valore HtmlTextWriterTag per il controllo ListControl.

(Ereditato da ListControl)
TagName

Ottiene il nome del tag del controllo. Questa proprietà viene usata principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
TemplateControl

Ottiene o imposta un riferimento al modello che contiene il controllo.

(Ereditato da Control)
TemplateSourceDirectory

Ottiene la directory virtuale dell'oggetto Page o dell'oggetto UserControl che contiene il controllo server corrente.

(Ereditato da Control)
Text

Ottiene o imposta la proprietà SelectedValue del controllo ListControl.

(Ereditato da ListControl)
TextAlign

Ottiene o imposta l'allineamento del testo delle caselle di controllo all'interno del gruppo.

ToolTip

Ottiene o imposta il testo visualizzato quando il puntatore del mouse viene posizionato sul controllo server Web.

(Ereditato da WebControl)
UniqueID

Ottiene l'identificatore univoco qualificato gerarchicamente per il controllo server.

(Ereditato da Control)
ValidateRequestMode

Ottiene o imposta un valore che indica se il controllo verifica la presenza di valori potenzialmente pericolosi nell'input proveniente dal browser.

(Ereditato da Control)
ValidationGroup

Ottiene o imposta il gruppo di controlli per cui il controllo derivato dalla classe ListControl causa la convalida quando esegue il postback al server.

(Ereditato da ListControl)
ViewState

Ottiene un dizionario di informazioni sullo stato che permette di salvare e ripristinare lo stato di visualizzazione di un controllo server attraverso più richieste per la stessa pagina.

(Ereditato da Control)
ViewStateIgnoresCase

Ottiene un valore che indica se l'oggetto StateBag non effettua la distinzione tra maiuscole e minuscole.

(Ereditato da Control)
ViewStateMode

Ottiene o imposta la modalità dello stato, visualizzazione di questo controllo.

(Ereditato da Control)
Visible

Ottiene o imposta un valore che indica se viene eseguito il rendering di un controllo server come interfaccia utente nella pagina.

(Ereditato da Control)
Width

Ottiene o imposta la larghezza del controllo server Web.

(Ereditato da WebControl)

Metodi

AddAttributesToRender(HtmlTextWriter)

Applica attributi e stili HTML per il rendering nell'oggetto HtmlTextWriter specificato.

(Ereditato da ListControl)
AddedControl(Control, Int32)

Chiamato dopo che un controllo figlio viene aggiunto alla raccolta 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 ControlCollection del controllo server.

(Ereditato da Control)
ApplyStyle(Style)

Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, sovrascrivendo eventuali elementi di stile del controllo. Il metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
ApplyStyleSheetSkin(Page)

Applica al controllo le proprietà di stile definite nel foglio di stile della pagina.

(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 recapita alla proprietà Trace in modo che vengano visualizzate quando è attivata la tracciatura per la pagina.

(Ereditato da Control)
ClearCachedClientID()

Imposta il valore memorizzato nella cache ClientID 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 proprietà ClientIDMode 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 proprietà Selected di tutti gli elementi su false.

(Ereditato da ListControl)
ConfirmInitState()

Imposta lo stato inizializzato del controllo con associazione a dati.

(Ereditato da BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia le proprietà non incapsulate dall'oggetto Style dal controllo server Web specificato al controllo server Web dal quale è stato chiamato il metodo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
CreateChildControls()

Viene chiamato dal framework della pagina ASP.NET per notificare ai controlli server che usano un'implementazione basata sulla composizione di creare gli eventuali controlli figlio in essi contenuti in preparazione per il postback o il rendering.

(Ereditato da Control)
CreateControlCollection()

Crea un nuovo oggetto ControlCollection per contenere i controlli figlio (valore letterale e server) del controllo del server.

(Ereditato da Control)
CreateControlStyle()

Crea un oggetto stile usato internamente dal controllo CheckBoxList per implementare tutte le proprietà correlate allo stile.

CreateDataSourceSelectArguments()

Crea un oggetto DataSourceSelectArguments predefinito utilizzato dal controllo con associazione a dati se non viene specificato alcun argomento.

(Ereditato da DataBoundControl)
DataBind()

Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio.

(Ereditato da Control)
DataBind()

Associa un'origine dati al controllo server richiamato e a tutti i controlli figlio.

(Ereditato da BaseDataBoundControl)
DataBind(Boolean)

Associa un'origine dati al controllo server chiamato e ai relativi controlli figlio con un'opzione per generare l'evento DataBinding.

(Ereditato da Control)
DataBindChildren()

Associa un'origine dati al controllo server e ai relativi controlli figlio.

(Ereditato da Control)
Dispose()

Abilita un controllo server alla pulizia finale prima che venga rilasciato 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, li crea.

(Ereditato da Control)
EnsureDataBound()

Chiama il metodo DataBind() se la proprietà DataSourceID è impostata e il controllo con associazione a dati è contrassegnato per la richiesta dell'associazione.

(Ereditato da BaseDataBoundControl)
EnsureID()

Crea un identificatore per i controlli a cui non è assegnato alcun identificatore.

(Ereditato da Control)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
FindControl(String)

Cerca un controllo server nel contenitore dei nomi corrente con il parametro id specificato.

(Ereditato da Control)
FindControl(String, Int32)

Cerca nel contenitore dei nomi corrente un controllo server con l'ID e l'offset di percorso specificati. Il metodo FindControl(String, Int32) restituisce sempre l'oggetto CheckBoxList.

Focus()

Imposta lo stato attivo per l'input su un controllo.

(Ereditato da Control)
GetData()

Recupera un oggetto DataSourceView utilizzato dal controllo associato a dati per eseguire le operazioni sui dati.

(Ereditato da DataBoundControl)
GetDataSource()

Recupera l'interfaccia IDataSource a cui è associato il controllo con associazione a dati, se presente.

(Ereditato da DataBoundControl)
GetDesignModeState()

Ottiene i dati della fase di progettazione per un controllo.

(Ereditato da Control)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetItemStyle(ListItemType, Int32)

Recupera lo stile del tipo di elemento specificato nell'indice specificato del controllo elenco.

GetRouteUrl(Object)

Ottiene l'URL corrispondente a un set di parametri di route.

(Ereditato da Control)
GetRouteUrl(RouteValueDictionary)

Ottiene l'URL corrispondente 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 a un nome della route.

(Ereditato da Control)
GetRouteUrl(String, RouteValueDictionary)

Ottiene l'URL che corrisponde a un set di parametri di route e a un nome della route.

(Ereditato da Control)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
GetUniqueIDRelativeTo(Control)

Restituisce la parte con prefisso della proprietà UniqueID 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 eventuali controlli figlio.

(Ereditato da Control)
IsLiteralContent()

Determina se il controllo server conserva solo il contenuto literal.

(Ereditato da Control)
LoadControlState(Object)

Ripristina le informazioni sullo stato del controllo da una richiesta di pagina precedente salvata dal metodo SaveControlState().

(Ereditato da Control)
LoadPostData(String, NameValueCollection)

Elabora i dati inseriti per il controllo CheckBoxList.

LoadViewState(Object)

Carica lo stato di visualizzazione precedentemente salvato del controllo DetailsView.

(Ereditato da ListControl)
MapPathSecure(String)

Recupera il percorso fisico al quale è associato 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 Object corrente.

(Ereditato da Object)
MergeStyle(Style)

Copia tutti gli elementi non vuoti dello stile specificato nel controllo Web, ma non sovrascrive eventuali elementi di stile del controllo. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
OnBubbleEvent(Object, EventArgs)

Determina se l'evento per il controllo server viene passato a un livello superiore nella gerarchia dei controlli server dell'interfaccia utente per la 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 con associazione a dati ai relativi 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.

OnInit(EventArgs)

Genera l'evento Init.

(Ereditato da Control)
OnInit(EventArgs)

Consente di gestire l'evento Init.

(Ereditato da BaseDataBoundControl)
OnLoad(EventArgs)

Genera l'evento Load.

(Ereditato da Control)
OnLoad(EventArgs)

Consente di gestire l'evento Load.

(Ereditato da DataBoundControl)
OnPagePreLoad(Object, EventArgs)

Imposta lo stato inizializzato del controllo con associazione a dati prima del caricamento del controllo.

(Ereditato da DataBoundControl)
OnPreRender(EventArgs)

Configura il controllo CheckBoxList prima del rendering nel client.

OnSelectedIndexChanged(EventArgs)

Genera l'evento SelectedIndexChanged. In tal 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 oggetto Stream utilizzato per leggere un file.

(Ereditato da Control)
PerformDataBinding(IEnumerable)

Associa l'origine dati specificata al controllo derivato dalla classe ListControl.

(Ereditato da ListControl)
PerformSelect()

Recupera i dati dall'origine dati associata.

(Ereditato da ListControl)
RaiseBubbleEvent(Object, EventArgs)

Assegna eventuali origini dell'evento e relative informazioni al controllo padre.

(Ereditato da Control)
RaisePostDataChangedEvent()

Notifica all'applicazione ASP.NET che lo stato del controllo CheckBoxList è cambiato.

RemovedControl(Control)

Chiamato dopo che un controllo figlio viene rimosso dalla raccolta Controls dell'oggetto Control.

(Ereditato da Control)
Render(HtmlTextWriter)

Visualizza il controllo CheckBoxList nel client.

RenderBeginTag(HtmlTextWriter)

Esegue il rendering del tag HTML di apertura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
RenderChildren(HtmlTextWriter)

Restituisce il contenuto degli elementi figlio di un controllo server a un oggetto HtmlTextWriter specificato, che scrive il contenuto di cui eseguire il rendering nel client.

(Ereditato da Control)
RenderContents(HtmlTextWriter)

Esegue il rendering degli elementi nel controllo ListControl.

(Ereditato da ListControl)
RenderControl(HtmlTextWriter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato e archivia le informazioni di traccia relative al controllo se la funzionalità di traccia è abilitata.

(Ereditato da Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Restituisce il contenuto del controllo server a un oggetto HtmlTextWriter specificato utilizzando un oggetto ControlAdapter specificato.

(Ereditato da Control)
RenderEndTag(HtmlTextWriter)

Esegue il rendering del tag HTML di chiusura del controllo nel writer specificato. Questo metodo viene utilizzato principalmente dagli sviluppatori di controlli.

(Ereditato da WebControl)
RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)

Esegue il rendering di un elemento di elenco nel controllo CheckBoxList.

ResolveAdapter()

Ottiene l'adattatore del 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 formato utilizzabile dal client richiedente.

(Ereditato da Control)
SaveControlState()

Salva tutte le modifiche dello stato di un controllo server apportate dopo il postback della pagina nel server.

(Ereditato da Control)
SaveViewState()

Salva lo stato di visualizzazione corrente del controllo derivato da ListControl e gli elementi in esso contenuti.

(Ereditato da ListControl)
SetDesignModeState(IDictionary)

Imposta i dati della fase di progettazione per un controllo.

(Ereditato da Control)
SetPostDataSelection(Int32)

Imposta la proprietà Selected di un controllo ListItem dopo l'invio 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)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando la chiave dei dati di traccia e il valore dei dati di traccia.

(Ereditato da Control)
SetTraceData(Object, Object, Object)

Imposta i dati di traccia per la traccia durante la fase di progettazione dei dati di rendering, utilizzando l'oggetto tracciato, 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 di partenza da cui iniziare la verifica e il salvataggio delle modifiche dello stato di visualizzazione in un controllo derivato da ListControl.

(Ereditato da ListControl)
ValidateDataSource(Object)

Verifica la possibilità di utilizzare l'oggetto a cui è associato un controllo con associazione a dati.

(Ereditato da DataBoundControl)
VerifyMultiSelect()

Determina se l'elenco supporta la modalità di selezione multipla.

(Ereditato da ListControl)

Eventi

CallingDataMethods

Si verifica quando vengono chiamati metodi di dati.

(Ereditato da DataBoundControl)
CreatingModelDataSource

Si verifica alla creazione dell'oggetto ModelDataSource.

(Ereditato da DataBoundControl)
DataBinding

Viene generato quando il controllo server viene associato a un'origine dati.

(Ereditato da Control)
DataBound

Viene dopo che un controllo server viene associato a un'origine dati.

(Ereditato da BaseDataBoundControl)
Disposed

Si verifica quando un controllo server viene rilasciato dalla memoria, ossia nell'ultima fase della durata di un controllo server quando viene richiesta una pagina ASP.NET.

(Ereditato da Control)
Init

Viene generato quando il controllo server viene inizializzato, ovvero nella prima fase della sua durata.

(Ereditato da Control)
Load

Viene generato quando il controllo server è 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 dall'elenco cambia tra un invio e l'altro al server.

(Ereditato da ListControl)
TextChanged

Si verifica quando le proprietà Text e SelectedValue vengono modificate.

(Ereditato da ListControl)
Unload

Viene generato quando il controllo server viene scaricato dalla memoria.

(Ereditato da Control)

Implementazioni dell'interfaccia esplicita

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 il 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 inseriti per il controllo CheckBoxList.

IPostBackDataHandler.RaisePostDataChangedEvent()

Viene generato se i dati inseriti relativi a un controllo sono cambiati.

IRepeatInfoUser.GetItemStyle(ListItemType, Int32)

Per una descrizione di questo membro, vedere GetItemStyle(ListItemType, Int32).

IRepeatInfoUser.HasFooter

Ottiene un valore che indica se il controllo elenco contiene una sezione di piè di pagina.

IRepeatInfoUser.HasHeader

Ottiene un valore che indica se il controllo elenco contiene una sezione di intestazione.

IRepeatInfoUser.HasSeparators

Ottiene un valore che indica se il controllo elenco contiene separatori tra gli elementi dell'elenco.

IRepeatInfoUser.RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter)

Per una descrizione di questo membro, vedere RenderItem(ListItemType, Int32, RepeatInfo, HtmlTextWriter).

IRepeatInfoUser.RepeatedItemCount

Ottiene il numero di elementi nel controllo elenco.

Metodi di estensione

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 metatabella per il controllo contenitore dei dati.

GetDefaultValues(INamingContainer)

Ottiene l'insieme di valori predefiniti per il controllo dei dati specificato.

GetMetaTable(INamingContainer)

Ottiene i metadati della tabella per il controllo dei dati specificato.

SetMetaTable(INamingContainer, MetaTable)

Imposta i metadati della tabella per il controllo dei dati specificato.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.

SetMetaTable(INamingContainer, MetaTable, Object)

Imposta il mapping dei valori predefiniti e dei metadati della tabella per il controllo dei dati specificato.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se sono disponibili i metadati della tabella.

EnableDynamicData(INamingContainer, Type)

Abilita il comportamento dati dinamici per il controllo dei dati specificato.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Abilita il comportamento dati dinamici per il controllo dei dati specificato.

EnableDynamicData(INamingContainer, Type, Object)

Abilita il comportamento dati dinamici per il controllo dei dati specificato.

Si applica a

Vedi anche