CheckBoxField Classe
Definizione
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 campo booleano visualizzato come casella di controllo in un controllo associato a dati.
public ref class CheckBoxField : System::Web::UI::WebControls::BoundFieldpublic class CheckBoxField : System.Web.UI.WebControls.BoundFieldtype CheckBoxField = class
inherit BoundFieldPublic Class CheckBoxField
Inherits BoundField- Ereditarietà
Esempio
Nell'esempio di codice seguente viene illustrato come usare un oggetto in un GridView controllo per visualizzare un CheckBoxField campo da un'origine dati Microsoft SQL Server con un tipo di dati booleano.
<%@ Page language="C#" %>
<!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>CheckBoxField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CheckBoxField Example</h3>
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="False"
runat="server">
<columns>
<asp:boundfield datafield="au_lname"
headertext="Last Name"/>
<asp:checkboxfield datafield="contract"
text="Contract"
headertext="Contract"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!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>CheckBoxField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CheckBoxField Example</h3>
<asp:gridview id="AuthorsGridView"
datasourceid="AuthorsSqlDataSource"
autogeneratecolumns="False"
runat="server">
<columns>
<asp:boundfield datafield="au_lname"
headertext="Last Name"/>
<asp:checkboxfield datafield="contract"
text="Contract"
headertext="Contract"/>
</columns>
</asp:gridview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Pubs sample database. -->
<asp:sqldatasource id="AuthorsSqlDataSource"
selectcommand="SELECT [au_lname], [au_fname], [address], [city], [state], [zip], [contract] FROM [authors]"
connectionstring="server=localhost;database=pubs;integrated security=SSPI"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Commenti
La CheckBoxField classe viene usata dai controlli associati ai dati (ad esempio GridView e DetailsView) per visualizzare il valore di un campo dati booleano in una casella di controllo. L'oggetto CheckBoxField viene visualizzato in modo diverso a seconda del controllo associato ai dati in cui viene usato. Ad esempio, il GridView controllo visualizza un CheckBoxField oggetto come colonna, mentre il DetailsView controllo lo visualizza come riga.
Nota
Una casella di controllo è disabilitata (sola lettura) finché il controllo associato a dati visualizza un record che contiene la casella di controllo in modalità di modifica. Per altre informazioni su come inserire un record in modalità di modifica, vedere la documentazione per il controllo padre contenente l'oggetto CheckBoxField .
Per specificare il campo da visualizzare in un CheckBoxField oggetto, impostare la proprietà con il DataField nome del campo.
Nota
Poiché una casella di controllo può visualizzare solo uno stato selezionato o non selezionato, un CheckBoxField oggetto può essere associato solo a un campo con un tipo di dati booleano o una stringa che può essere analizzata da Parse.
È possibile visualizzare una didascalia accanto a ogni casella di controllo impostando la Text proprietà. Un CheckBoxField oggetto è nascosto in un controllo associato a dati quando la Visible proprietà è impostata su false. Per impedire la modifica del valore di un campo in modalità di modifica, impostare la ReadOnly proprietà su true. Nei controlli associati a dati che supportano l'inserimento di record (ad esempio il DetailsView controllo), è possibile nascondere un CheckBoxField oggetto in modalità di inserimento impostando la InsertVisible proprietà su false.
È possibile personalizzare le sezioni intestazione e piè di pagina di un CheckBoxField oggetto. Per visualizzare una didascalia nelle sezioni intestazione o piè di pagina, impostare rispettivamente le HeaderText proprietà o FooterText . Anziché visualizzare il testo nella sezione intestazione, è possibile visualizzare un'immagine impostando la HeaderImageUrl proprietà. La sezione intestazione può essere nascosta nell'oggetto CheckBoxField impostando la ShowHeader proprietà su false.
Nota
Alcuni controlli associati a dati ,ad esempio il GridView controllo, possono visualizzare o nascondere solo l'intera sezione dell'intestazione del controllo. Questi controlli associati a dati non supportano la ShowHeader proprietà per un singolo campo associato. Per visualizzare o nascondere l'intera sezione dell'intestazione di un controllo associato a dati (se disponibile), usare la proprietà del ShowHeader controllo.
È anche possibile personalizzare l'aspetto dell'oggetto CheckBoxField (colore del carattere, colore di sfondo e così via) impostando le proprietà dello stile per le diverse parti del campo. Nella tabella seguente sono elencate le diverse proprietà di stile.
| Proprietà Style | Descrizione |
|---|---|
| ControlStyle | Impostazioni di stile per i controlli server Web figlio dell'oggetto CheckBoxField . |
| FooterStyle | Impostazioni di stile per la sezione piè di pagina dell'oggetto CheckBoxField . |
| HeaderStyle | Impostazioni di stile per la sezione intestazione dell'oggetto CheckBoxField . |
| ItemStyle | Impostazioni di stile per gli elementi di dati nell'oggetto CheckBoxField . |
Costruttori
| CheckBoxField() |
Inizializza una nuova istanza della classe CheckBoxField. |
Proprietà
| AccessibleHeaderText |
Ottiene o imposta il testo che viene sottoposto a rendering come valore della proprietà |
| ApplyFormatInEditMode |
Esegue l'override della proprietà ApplyFormatInEditMode. Questa proprietà non è supportata dalla classe CheckBoxField. |
| Control |
Ottiene un riferimento al controllo dati a cui l'oggetto DataControlField è associato. (Ereditato da DataControlField) |
| ControlStyle |
Ottiene lo stile di tutti i controlli server Web contenuti nell'oggetto DataControlField. (Ereditato da DataControlField) |
| ConvertEmptyStringToNull |
Esegue l'override della proprietà ConvertEmptyStringToNull. Questa proprietà non è supportata dalla classe CheckBoxField. |
| DataField |
Ottiene o imposta il nome del campo dati da associare all'oggetto CheckBoxField. |
| DataFormatString |
Ottiene o imposta la stringa in cui è specificato il formato di visualizzazione per il valore del campo. Questa proprietà non è supportata dalla classe CheckBoxField. |
| DesignMode |
Ottiene un valore che indica se un campo di controllo dati è attualmente visualizzato in un ambiente di progettazione. (Ereditato da DataControlField) |
| FooterStyle |
Ottiene o imposta lo stile del piè di pagina del campo di controllo dati. (Ereditato da DataControlField) |
| FooterText |
Ottiene o imposta il testo visualizzato nell'elemento del piè di pagina del campo di controllo dati. (Ereditato da DataControlField) |
| HeaderImageUrl |
Ottiene o imposta l'URL di un'immagine che viene visualizzata nell'elemento di intestazione di un campo di controlli dati. (Ereditato da DataControlField) |
| HeaderStyle |
Ottiene o imposta lo stile dell'intestazione del campo di controllo dati. (Ereditato da DataControlField) |
| HeaderText |
Ottiene o imposta il testo visualizzato nell'intestazione di un controllo dati. (Ereditato da BoundField) |
| HtmlEncode |
Esegue l'override della proprietà HtmlEncode. Questa proprietà non è supportata dalla classe CheckBoxField. |
| HtmlEncodeFormatString |
Ottiene o imposta un valore che indica se il testo formattato deve essere codificato in formato HTML prima di essere visualizzato. |
| InsertVisible |
Ottiene un valore che indica se l'oggetto DataControlField è visibile quando il controllo con associazione a dati padre si trova in modalità di inserimento. (Ereditato da DataControlField) |
| IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataControlField) |
| ItemStyle |
Ottiene lo stile di tutti i contenuti basati sul testo visualizzati da un campo di controllo dati. (Ereditato da DataControlField) |
| NullDisplayText |
Ottiene o imposta il testo visualizzato per un campo quando il valore del campo è |
| ReadOnly |
Ottiene o imposta un valore che indica se il valore del campo può essere modificato in modalità di modifica. (Ereditato da BoundField) |
| ShowHeader |
Ottiene o imposta un valore che indica se viene eseguito il rendering dell'elemento di intestazione di un campo di controllo dati. (Ereditato da DataControlField) |
| SortExpression |
Ottiene o imposta l'espressione di ordinamento che viene utilizzata da un controllo origine dati per ordinare i dati. (Ereditato da DataControlField) |
| SupportsHtmlEncode |
Ottiene un valore Boolean che indica se il controllo supporta la codifica HTML. |
| Text |
Ottiene o imposta la didascalia accanto a ciascuna casella di controllo in un oggetto CheckBoxField. |
| ValidateRequestMode |
Ottiene o imposta un valore che determina se il controllo convalida l'input del client. (Ereditato da BoundField) |
| ViewState |
Ottiene un dizionario di informazioni sullo stato che consente di salvare e ripristinare lo stato di visualizzazione di un oggetto DataControlField tra più richieste per la stessa pagina. (Ereditato da DataControlField) |
| Visible |
Ottiene o imposta un valore che indica se viene eseguito il rendering di un campo di controllo dati. (Ereditato da DataControlField) |
Metodi
| CloneField() |
Crea una copia duplicata dell'oggetto corrente derivato da DataControlField. (Ereditato da DataControlField) |
| CopyProperties(DataControlField) |
Copia le proprietà dell'oggetto CheckBoxField corrente nell'oggetto DataControlField specificato. |
| CreateField() |
Crea un oggetto CheckBoxField vuoto. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean) |
Inserisce nell'oggetto IDictionary specificato i valori dell'oggetto DataControlFieldCell specificato. |
| FormatDataValue(Object, Boolean) |
Esegue la formattazione del valore di campo specificato per una cella nell'oggetto BoundField. (Ereditato da BoundField) |
| GetDesignTimeValue() |
Consente di recuperare il valore utilizzato per il valore del campo quando si esegue il rendering dell'oggetto CheckBoxField in una finestra di progettazione. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| GetValue(Control) |
Recupera il valore del campo associato all'oggetto BoundField. (Ereditato da BoundField) |
| Initialize(Boolean, Control) |
Inizializza l'oggetto BoundField. (Ereditato da BoundField) |
| InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32) |
Inizializza l'oggetto TableCell specificato nello stato della riga specificata. (Ereditato da BoundField) |
| InitializeDataCell(DataControlFieldCell, DataControlRowState) |
Inizializza l'oggetto DataControlFieldCell specificato nello stato della riga specificata. |
| LoadViewState(Object) |
Ripristina le informazioni sullo stato di visualizzazione precedentemente archiviate per questo campo. (Ereditato da BoundField) |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| OnDataBindField(Object, EventArgs) |
Consente di associare il valore di un campo a una casella di controllo nell'oggetto CheckBoxField. |
| OnFieldChanged() |
Genera l'evento |
| SaveViewState() |
Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da DataControlField) |
| ToString() |
Restituisce una stringa che rappresenta questo oggetto DataControlField. (Ereditato da DataControlField) |
| TrackViewState() |
Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina. (Ereditato da DataControlField) |
| ValidateSupportsCallback() |
Determina se i controlli contenuti in un oggetto CheckBoxField supportano i callback. |
Implementazioni dell'interfaccia esplicita
| IDataSourceViewSchemaAccessor.DataSourceViewSchema |
Ottiene o imposta lo schema associato all'oggetto DataControlField. (Ereditato da DataControlField) |
| IStateManager.IsTrackingViewState |
Ottiene un valore che indica se l'oggetto DataControlField sta salvando le modifiche apportate al relativo stato di visualizzazione. (Ereditato da DataControlField) |
| IStateManager.LoadViewState(Object) |
Ripristina lo stato di visualizzazione del campo del controllo dati salvato in precedenza. (Ereditato da DataControlField) |
| IStateManager.SaveViewState() |
Salva le modifiche apportate allo stato di visualizzazione DataControlField dal momento in cui è stato eseguito il postback della pagina al server. (Ereditato da DataControlField) |
| IStateManager.TrackViewState() |
Mediante questo metodo l'oggetto DataControlField tiene traccia delle modifiche apportate al relativo stato di visualizzazione in modo che possano essere memorizzate nella proprietà ViewState del controllo e mantenute nelle richieste della stessa pagina. (Ereditato da DataControlField) |