CheckBoxField Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein boolesches Feld dar, das als Kontrollkästchen in einem datengebundenen Steuerelement angezeigt wird.

public ref class CheckBoxField : System::Web::UI::WebControls::BoundField

public class CheckBoxField : System.Web.UI.WebControls.BoundField

type CheckBoxField = class
    inherit BoundField

Public Class CheckBoxField
Inherits BoundField

Vererbung: Object

DataControlField

BoundField
CheckBoxField

Beispiele

Das folgende Codebeispiel veranschaulicht, wie ein CheckBoxField Objekt in einem GridView Steuerelement verwendet wird, um ein Feld aus einer Microsoft SQL Server Datenquelle mit einem booleschen Datentyp anzuzeigen.


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

Hinweise

Die CheckBoxField Klasse wird von datengebundenen Steuerelementen (z. B GridView . und DetailsView) verwendet, um den Wert eines booleschen Datenfelds in einem Kontrollkästchen anzuzeigen. Das CheckBoxField Objekt wird je nach datengebundenem Steuerelement, in dem es verwendet wird, unterschiedlich angezeigt. Beispielsweise zeigt das GridView Steuerelement ein CheckBoxField Objekt als Spalte an, während das DetailsView Steuerelement es als Zeile anzeigt.

Hinweis

Ein Kontrollkästchen ist deaktiviert (schreibgeschützt), bis das datengebundene Steuerelement einen Datensatz anzeigt, der das Kontrollkästchen im Bearbeitungsmodus enthält. Weitere Informationen zum Einfügen eines Datensatzes in den Bearbeitungsmodus finden Sie in der Dokumentation für das übergeordnete Steuerelement, das das CheckBoxField Objekt enthält.

Wenn Sie das Feld angeben möchten, das in einem CheckBoxField Objekt angezeigt werden soll, legen Sie die DataField Eigenschaft mit dem Namen des Felds fest.

Hinweis

Da ein Kontrollkästchen nur einen markierten oder nicht ausgewählten Zustand anzeigen kann, kann ein CheckBoxField Objekt nur an ein Feld mit einem booleschen Datentyp oder einer Zeichenfolge gebunden werden, die analysiert Parsewerden kann.

Sie können neben jedem Kontrollkästchen eine Beschriftung anzeigen, indem Sie die Text Eigenschaft festlegen. Ein CheckBoxField Objekt wird in einem datengebundenen Steuerelement ausgeblendet, wenn die Visible Eigenschaft auf false". Um zu verhindern, dass der Wert eines Felds im Bearbeitungsmodus geändert wird, legen Sie die ReadOnly Eigenschaft auf true. In datengebundenen Steuerelementen, die das Einfügen von Datensätzen (z. B. das DetailsView Steuerelement) unterstützen, können Sie ein CheckBoxField Objekt im Einfügemodus ausblenden, indem Sie die InsertVisible Eigenschaft auf falsefestlegen.

Sie können die Kopf- und Fußzeilenabschnitte eines CheckBoxField Objekts anpassen. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitte anzuzeigen, legen Sie die HeaderText oder FooterText Eigenschaften bzw. Anstatt Text im Kopfzeilenabschnitt anzuzeigen, können Sie ein Bild anzeigen, indem Sie die HeaderImageUrl Eigenschaft festlegen. Der Kopfzeilenabschnitt kann im CheckBoxField Objekt ausgeblendet werden, indem die ShowHeader Eigenschaft auf false.

Hinweis

Einige datengebundene Steuerelemente (z. B. das GridView Steuerelement) können nur den gesamten Kopfzeilenabschnitt des Steuerelements anzeigen oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader Eigenschaft für ein einzelnes gebundenes Feld nicht. Verwenden Sie die Eigenschaft des Steuerelements, um den gesamten Kopfzeilenabschnitt eines datengebundenen Steuerelements ShowHeader (sofern verfügbar) anzuzeigen oder auszublenden.

Sie können auch die Darstellung des CheckBoxField Objekts (Schriftfarbe, Hintergrundfarbe usw.) anpassen, indem Sie die Formatvorlageneigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Formatvorlageneigenschaften aufgeführt.

Style-Eigenschaft	BESCHREIBUNG
ControlStyle	Die Formatvorlageneinstellungen für die untergeordneten Webserversteuerelemente des CheckBoxField Objekts.
FooterStyle	Die Formatvorlageneinstellungen für den Fußzeilenabschnitt des CheckBoxField Objekts.
HeaderStyle	Die Formatvorlageneinstellungen für den Kopfzeilenabschnitt des CheckBoxField Objekts.
ItemStyle	Die Formatvorlageneinstellungen für die Datenelemente im CheckBoxField Objekt.

Konstruktoren

CheckBoxField()

Initialisiert eine neue Instanz der CheckBoxField-Klasse.

Eigenschaften

AccessibleHeaderText	Ruft Text ab, der in einigen Steuerelementen als `AbbreviatedText`-Eigenschaftswert gerendert wird, oder legt diesen fest. (Geerbt von DataControlField)
ApplyFormatInEditMode	Überschreibt die ApplyFormatInEditMode-Eigenschaft. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.
Control	Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist. (Geerbt von DataControlField)
ControlStyle	Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab. (Geerbt von DataControlField)
ConvertEmptyStringToNull	Überschreibt die ConvertEmptyStringToNull-Eigenschaft. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.
DataField	Ruft den Namen des Datenfelds ab, das an das CheckBoxField-Objekt gebunden werden soll, oder legt diesen fest.
DataFormatString	Ruft die Zeichenfolge ab, die das Anzeigeformat für den Wert des Felds angibt, oder legt diese fest. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.
DesignMode	Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField)
FooterStyle	Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest. (Geerbt von DataControlField)
FooterText	Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest. (Geerbt von DataControlField)
HeaderImageUrl	Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest. (Geerbt von DataControlField)
HeaderStyle	Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest. (Geerbt von DataControlField)
HeaderText	Ruft den Text ab, der im Header eines Datensteuerelements angezeigt wird, oder legt diesen fest. (Geerbt von BoundField)
HtmlEncode	Überschreibt die HtmlEncode-Eigenschaft. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.
HtmlEncodeFormatString	Ruft einen Wert ab, der angibt, ob der formatierte Text vor der Anzeige HTML-codiert werden soll, oder legt diesen fest.
InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von DataControlField)
ItemStyle	Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden. (Geerbt von DataControlField)
NullDisplayText	Ruft den Text ab, der für ein Feld angezeigt wird, wenn der Wert des Felds `null` ist, oder legt diesen fest. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.
ReadOnly	Ruft einen Wert ab, der angibt, ob der Feldwert im Bearbeitungsmodus geändert werden kann, oder legt diesen fest. (Geerbt von BoundField)
ShowHeader	Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest. (Geerbt von DataControlField)
SortExpression	Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest. (Geerbt von DataControlField)
SupportsHtmlEncode	Ruft einen booleschen Wert ab, der angibt, ob das Steuerelement HTML-Codierung unterstützt.
Text	Ruft die Beschriftung ab, die neben den einzelnen Kontrollkästchen in einem CheckBoxField-Objekt angezeigt werden soll, oder legt diese fest.
ValidateRequestMode	Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob das Steuerelement Clienteingaben überprüft. (Geerbt von BoundField)
ViewState	Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können. (Geerbt von DataControlField)
Visible	Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest. (Geerbt von DataControlField)

Methoden

CloneField()	Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts. (Geerbt von DataControlField)
CopyProperties(DataControlField)	Kopiert die Eigenschaften des aktuellen CheckBoxField-Objekts in das angegebene DataControlField-Objekt.
CreateField()	Erstellt ein leeres CheckBoxField-Objekt.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Füllt das angegebene IDictionary-Objekt mit den Werten aus dem angegebenen DataControlFieldCell-Objekt.
FormatDataValue(Object, Boolean)	Formatiert den angegebenen Feldwert für eine Zelle im BoundField-Objekt. (Geerbt von BoundField)
GetDesignTimeValue()	Ruft beim Rendern des CheckBoxField-Objekts in einem Designer den für den Wert des Felds verwendeten Wert ab.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(Control)	Ruft den Wert des Felds ab, das an das BoundField-Objekt gebunden ist. (Geerbt von BoundField)
Initialize(Boolean, Control)	Initialisiert das BoundField-Objekt. (Geerbt von BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand. (Geerbt von BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Initialisiert das angegebene DataControlFieldCell-Objekt mit dem angegebenen Zeilenzustand.
LoadViewState(Object)	Stellt die zuvor gespeicherten Ansichtszustandsinformationen für das Feld wieder her. (Geerbt von BoundField)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnDataBindField(Object, EventArgs)	Bindet den Wert eines Felds an ein Kontrollkästchen im CheckBoxField-Objekt.
OnFieldChanged()	Löst das `FieldChanged`-Ereignis aus. (Geerbt von DataControlField)
SaveViewState()	Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Geerbt von DataControlField)
ToString()	Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt. (Geerbt von DataControlField)
TrackViewState()	Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden. (Geerbt von DataControlField)
ValidateSupportsCallback()	Bestimmt, ob die in einem CheckBoxField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest. (Geerbt von DataControlField)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert. (Geerbt von DataControlField)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her. (Geerbt von DataControlField)
IStateManager.SaveViewState()	Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde. (Geerbt von DataControlField)
IStateManager.TrackViewState()	Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden. (Geerbt von DataControlField)

Gilt für

CheckBoxField Klasse

Definition

Beispiele

Hinweise

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für

Siehe auch

Zusätzliche Ressourcen