CheckBoxField Klasse
Definition
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::BoundFieldpublic class CheckBoxField : System.Web.UI.WebControls.BoundFieldtype CheckBoxField = class
inherit BoundFieldPublic Class CheckBoxField
Inherits BoundField- Vererbung
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 |
| 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 |
| 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 |
| 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) |