CheckBoxField Klasse

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

Im folgenden Codebeispiel wird 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 GridView . B. und DetailsView) verwendet, um den Wert eines booleschen Datenfelds in einem Kontrollkästchen anzuzeigen. Das CheckBoxField Objekt wird je nach dem datengebundenen 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. Wenn Sie eine Beschriftung in den Kopf- oder Fußzeilenabschnitten anzeigen möchten, legen Sie die bzwFooterText. die HeaderText Eigenschaften fest. Statt 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 ein- 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) ein- oder auszublenden.

Sie können auch die Darstellung des CheckBoxField Objekts (Schriftfarbe, Hintergrundfarbe usw.) anpassen, indem Sie die Formateigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Formateigenschaften 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

Name	Beschreibung
CheckBoxField()	Initialisiert eine neue Instanz der CheckBoxField-Klasse.

Eigenschaften

Name	Beschreibung
AccessibleHeaderText	Dient zum Abrufen oder Festlegen von Text, der `AbbreviatedText` in einigen Steuerelementen als Eigenschaftswert gerendert wird. (Geerbt von DataControlField)
ApplyFormatInEditMode	Setzt die ApplyFormatInEditMode Eigenschaft außer Kraft. 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 Webserversteuerelemente ab, die im DataControlField Objekt enthalten sind. (Geerbt von DataControlField)
ConvertEmptyStringToNull	Setzt die ConvertEmptyStringToNull Eigenschaft außer Kraft. Diese Eigenschaft wird von der CheckBoxField Klasse nicht unterstützt.
DataField	Dient zum Abrufen oder Festlegen des Namens des Datenfelds, das an das CheckBoxField Objekt gebunden werden soll.
DataFormatString	Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Anzeigeformat für den Wert des Felds angibt. Diese Eigenschaft wird von der CheckBoxField Klasse nicht unterstützt.
DesignMode	Ruft einen Wert ab, der angibt, ob ein Datensteuerelementfeld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField)
FooterStyle	Dient zum Abrufen oder Festlegen der Formatvorlage der Fußzeile des Datensteuerelementfelds. (Geerbt von DataControlField)
FooterText	Dient zum Abrufen oder Festlegen des Texts, der im Fußzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
HeaderImageUrl	Dient zum Abrufen oder Festlegen der URL eines Bilds, das im Kopfzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
HeaderStyle	Dient zum Abrufen oder Festlegen des Stils der Kopfzeile des Datensteuerelementfelds. (Geerbt von DataControlField)
HeaderText	Ruft den Text ab, der in der Kopfzeile eines Datensteuerelements angezeigt wird, oder legt diesen fest. (Geerbt von BoundField)
HtmlEncode	Setzt die HtmlEncode Eigenschaft außer Kraft. Diese Eigenschaft wird von der CheckBoxField Klasse nicht unterstützt.
HtmlEncodeFormatString	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der formatierte Text HTML-codiert sein soll, bevor er angezeigt wird.
InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt sichtbar ist, wenn sich das übergeordnete datengebundene Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField)
ItemStyle	Ruft das Format aller textbasierten Inhalte ab, die von einem Datensteuerelementfeld angezeigt werden. (Geerbt von DataControlField)
NullDisplayText	Dient zum Abrufen oder Festlegen des Texts, der für ein Feld angezeigt wird, wenn der Wert des Felds ist `null`. Diese Eigenschaft wird von der CheckBoxField Klasse nicht unterstützt.
ReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Wert des Felds im Bearbeitungsmodus geändert werden kann. (Geerbt von BoundField)
ShowHeader	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Kopfzeilenelement eines Datensteuerelementfelds gerendert wird. (Geerbt von DataControlField)
SortExpression	Dient zum Abrufen oder Festlegen eines Sortierausdrucks, der von einem Datenquellensteuerelement zum Sortieren von Daten verwendet wird. (Geerbt von DataControlField)
SupportsHtmlEncode	Ruft einen booleschen Wert ab, der angibt, ob das Steuerelement html-Codierung unterstützt.
Text	Dient zum Abrufen oder Festlegen der Beschriftung, die neben jedem Kontrollkästchen in einem CheckBoxField Objekt angezeigt werden soll.
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob das Steuerelement die Clienteingabe überprüft oder nicht. (Geerbt von BoundField)
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von DataControlField)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Datensteuerelementfeld gerendert wird. (Geerbt von DataControlField)

Methoden

Name	Beschreibung
CloneField()	Erstellt eine duplizierte Kopie des aktuellen DataControlFieldabgeleiteten 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 dem aktuellen Objekt entspricht. (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 den Wert ab, der beim Rendern des CheckBoxField Objekts in einem Designer für den Wert des Felds verwendet wird.
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die 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 in den angegebenen Zeilenzustand. (Geerbt von BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Initialisiert das angegebene DataControlFieldCell Objekt in den angegebenen Zeilenzustand.
LoadViewState(Object)	Stellt die zuvor gespeicherten Ansichtsstatusinformationen für dieses Feld wieder her. (Geerbt von BoundField)
MemberwiseClone()	Erstellt eine flache Kopie der 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 am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet 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 am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField)
ValidateSupportsCallback()	Bestimmt, ob die in einem CheckBoxField Objekt enthaltenen Steuerelemente Rückrufe unterstützen.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ruft das diesem DataControlField Objekt zugeordnete Schema ab oder legt es fest. (Geerbt von DataControlField)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelementfelds wieder her. (Geerbt von DataControlField)
IStateManager.SaveViewState()	Speichert die am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet wurde. (Geerbt von DataControlField)
IStateManager.TrackViewState()	Bewirkt, dass das DataControlField Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?

Freigeben über

CheckBoxField Klasse

Definition

Beispiele

Hinweise

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

Feedback