CheckBoxField Klasse

Definition

Stellt ein boolesches Feld dar, das als Kontrollkästchen in einem datengebundenen Steuerelement angezeigt wird.Represents a Boolean field that is displayed as a check box in a data-bound control.

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein CheckBoxField -Objekt in GridView einem-Steuerelement verwendet wird, um ein Feld aus einer Microsoft SQL Server Datenquelle mit einem booleschen Datentyp anzuzeigen.The following code example demonstrates how to use a CheckBoxField object in a GridView control to display a field from a Microsoft SQL Server data source with a Boolean data type.


<%@ 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 Daten gebundenen Steuerelementen ( GridView z. b DetailsView. und) verwendet, um den Wert eines booleschen Datenfelds in einem Kontrollkästchen anzuzeigen.The CheckBoxField class is used by data-bound controls (such as GridView and DetailsView) to display the value of a Boolean data field in a check box. Das CheckBoxField Objekt wird unterschiedlich angezeigt, je nach dem Daten gebundenen Steuerelement, in dem es verwendet wird.The CheckBoxField object is displayed differently depending on the data-bound control in which it is used. Das GridView -Steuerelement zeigt z. CheckBoxField b. ein-Objekt als Spalte DetailsView an, während das-Steuerelement es als Zeile anzeigt.For example, the GridView control displays a CheckBoxField object as a column, while the DetailsView control displays it as a row.

Hinweis

Ein Kontrollkästchen ist deaktiviert (schreibgeschützt), bis das Daten gebundene Steuerelement einen Datensatz anzeigt, der das Kontrollkästchen im Bearbeitungsmodus enthält.A check box is disabled (read-only) until the data-bound control displays a record that contains the check box in edit mode. Weitere Informationen zum Einfügen eines Datensatzes in den Bearbeitungsmodus finden Sie in der Dokumentation für das übergeordnete Steuerelement, CheckBoxField das das Objekt enthält.For more information on how to put a record into edit mode, see the documentation for the parent control that contains the CheckBoxField object.

Um das Feld anzugeben, das in einem CheckBoxField -Objekt angezeigt werden DataField soll, legen Sie die-Eigenschaft mit dem Namen des Felds fest.To specify the field to display in a CheckBoxField object, set the DataField property with the field's name.

Hinweis

Da ein Kontrollkästchen nur einen ausgewählten 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 von Parseanalysiert werden kann.Because a check box can display only a selected or an unselected state, a CheckBoxField object can be bound only to a field with a Boolean data type or a string that can be parsed by Parse.

Sie können eine Beschriftung neben jedem Kontrollkästchen anzeigen, indem Sie die Text -Eigenschaft festlegen.You can display a caption next to each check box by setting the Text property. Ein CheckBoxField -Objekt wird in einem Daten gebundenen Steuerelement ausgeblendet, Visible wenn die-Eigenschaft falseauf festgelegt ist.A CheckBoxField object is hidden in a data-bound control when the Visible property is set to false. Legen Sie die ReadOnly -Eigenschaft auf truefest, um zu verhindern, dass der Wert eines Felds im Bearbeitungsmodus geändert wird.To prevent the value of a field from being modified in edit mode, set the ReadOnly property to true. Wenn Sie Daten gebundene Steuerelemente einfügen (z. b. das DetailsView -Steuerelement), können Sie CheckBoxField ein-Objekt im Einfügemodus ausblenden false, indem Sie die InsertVisible -Eigenschaft auf festlegen.In data-bound controls that support inserting records (such as the DetailsView control), you can hide a CheckBoxField object in insert mode by setting the InsertVisible property to false.

Sie können die Kopf-und Fußzeilen Abschnitte eines CheckBoxField -Objekts anpassen.You can customize the header and footer sections of a CheckBoxField object. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitte anzuzeigen, legen Sie die HeaderText oder FooterText Eigenschaften bzw.To display a caption in the header or footer sections, set the HeaderText or FooterText properties, respectively. Anstatt Text im Header Abschnitt anzuzeigen, können Sie ein Bild anzeigen, indem Sie die HeaderImageUrl -Eigenschaft festlegen.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. Der Header Abschnitt kann im CheckBoxField -Objekt ausgeblendet werden, indem die ShowHeader -Eigenschaft auf falsefestgelegt wird.The header section can be hidden in the CheckBoxField object by setting the ShowHeader property to false.

Hinweis

Einige Daten gebundene Steuerelemente (z. b GridView . das-Steuerelement) können nur den gesamten Header Abschnitt des Steuer Elements anzeigen oder ausblenden.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Diese Daten gebundenen Steuerelemente unterstützen die ShowHeader -Eigenschaft für ein einzelnes gebundenes Feld nicht.These data-bound controls do not support the ShowHeader property for an individual bound field. Verwenden Sie die-Eigenschaft des- ShowHeader Steuer Elements, um den gesamten Header Abschnitt eines Daten gebundenen Steuer Elements (falls verfügbar) anzuzeigen oder auszublenden.To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

Sie können auch die Darstellung des CheckBoxField Objekts (Schriftfarbe, Hintergrundfarbe usw.) anpassen, indem Sie die Stileigenschaften für die verschiedenen Teile des Felds festlegen.You also can customize the appearance of the CheckBoxField object (font color, background color, and so on) by setting the style properties for the different parts of the field. In der folgenden Tabelle werden die verschiedenen Stileigenschaften aufgelistet.The following table lists the different style properties.

Style-EigenschaftStyle property BeschreibungDescription
ControlStyle Die Stileinstellungen für die untergeordneten Webserver-Steuerelemente CheckBoxField des-Objekts.The style settings for the child Web server controls of the CheckBoxField object.
FooterStyle Die Stileinstellungen für den Footerbereich des CheckBoxField -Objekts.The style settings for the footer section of the CheckBoxField object.
HeaderStyle Die Stileinstellungen für den Header Abschnitt des CheckBoxField -Objekts.The style settings for the header section of the CheckBoxField object.
ItemStyle Die Stileinstellungen für die Datenelemente im CheckBoxField -Objekt.The style settings for the data items in the CheckBoxField object.

Konstruktoren

CheckBoxField()

Initialisiert eine neue Instanz der CheckBoxField-Klasse.Initializes a new instance of the CheckBoxField class.

Eigenschaften

AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Geerbt von DataControlField)
ApplyFormatInEditMode

Überschreibt die ApplyFormatInEditMode-Eigenschaft.Overrides the ApplyFormatInEditMode property. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.This property is not supported by the CheckBoxField class.

Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.Gets a reference to the data control that the DataControlField object is associated with.

(Geerbt von DataControlField)
ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.Gets the style of any Web server controls contained by the DataControlField object.

(Geerbt von DataControlField)
ConvertEmptyStringToNull

Überschreibt die ConvertEmptyStringToNull-Eigenschaft.Overrides the ConvertEmptyStringToNull property. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.This property is not supported by the CheckBoxField class.

DataField

Ruft den Namen des Datenfelds ab, das an das CheckBoxField-Objekt gebunden werden soll, oder legt diesen fest.Gets or sets the name of the data field to bind to the CheckBoxField object.

DataFormatString

Ruft die Zeichenfolge ab, die das Anzeigeformat für den Wert des Felds angibt, oder legt diese fest.Gets or sets the string that specifies the display format for the value of the field. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.This property is not supported by the CheckBoxField class.

DesignMode

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Geerbt von DataControlField)
FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the footer of the data control field.

(Geerbt von DataControlField)
FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the footer item of a data control field.

(Geerbt von DataControlField)
HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Geerbt von DataControlField)
HeaderStyle

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the header of the data control field.

(Geerbt von DataControlField)
HeaderText

Ruft den Text ab, der im Header eines Datensteuerelements angezeigt wird, oder legt diesen fest.Gets or sets the text that is displayed in the header of a data control.

(Geerbt von BoundField)
HtmlEncode

Überschreibt die HtmlEncode-Eigenschaft.Overrides the HtmlEncode property. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.This property is not supported by the CheckBoxField class.

HtmlEncodeFormatString

Ruft einen Wert ab, der angibt, ob der formatierte Text vor der Anzeige HTML-codiert werden soll, oder legt diesen fest.Gets or sets a value that indicates whether the formatted text should be HTML encoded before it is displayed.

InsertVisible

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Geerbt von DataControlField)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Geerbt von DataControlField)
ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.Gets the style of any text-based content displayed by a data control field.

(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.Gets or sets the text displayed for a field when the field's value is null. Diese Eigenschaft wird von der CheckBoxField-Klasse nicht unterstützt.This property is not supported by the CheckBoxField class.

ReadOnly

Ruft einen Wert ab, der angibt, ob der Feldwert im Bearbeitungsmodus geändert werden kann, oder legt diesen fest.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

(Geerbt von BoundField)
ShowHeader

Ruft einen Wert ab, der angibt, ob das Headerelement eines Datensteuerelementfelds gerendert wird, oder legt diesen fest.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Geerbt von DataControlField)
SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.Gets or sets a sort expression that is used by a data source control to sort data.

(Geerbt von DataControlField)
SupportsHtmlEncode

Ruft einen booleschen Wert ab, der angibt, ob das Steuerelement HTML-Codierung unterstützt.Gets a Boolean value indicating whether the control supports HTML encoding.

Text

Ruft die Beschriftung ab, die neben den einzelnen Kontrollkästchen in einem CheckBoxField-Objekt angezeigt werden soll, oder legt diese fest.Gets or sets the caption to display next to each check box in a CheckBoxField object.

ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der bestimmt, ob das Steuerelement Clienteingaben überprüft.Gets or sets a value that determines whether the control validates client input or not.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Geerbt von DataControlField)
Visible

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.Gets or sets a value indicating whether a data control field is rendered.

(Geerbt von DataControlField)

Methoden

CloneField()

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.Creates a duplicate copy of the current DataControlField-derived object.

(Geerbt von DataControlField)
CopyProperties(DataControlField)

Kopiert die Eigenschaften des aktuellen CheckBoxField-Objekts in das angegebene DataControlField-Objekt.Copies the properties of the current CheckBoxField object to the specified DataControlField object.

CreateField()

Erstellt ein leeres CheckBoxField-Objekt.Creates an empty CheckBoxField object.

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Füllt das angegebene IDictionary-Objekt mit den Werten aus dem angegebenen DataControlFieldCell-Objekt.Fills the specified IDictionary object with the values from the specified DataControlFieldCell object.

FormatDataValue(Object, Boolean)

Formatiert den angegebenen Feldwert für eine Zelle im BoundField-Objekt.Formats the specified field value for a cell in the BoundField object.

(Geerbt von BoundField)
GetDesignTimeValue()

Ruft beim Rendern des CheckBoxField-Objekts in einem Designer den für den Wert des Felds verwendeten Wert ab.Retrieves the value used for the field's value when rendering the CheckBoxField object in a designer.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(Control)

Ruft den Wert des Felds ab, das an das BoundField-Objekt gebunden ist.Retrieves the value of the field bound to the BoundField object.

(Geerbt von BoundField)
Initialize(Boolean, Control)

Initialisiert das BoundField-Objekt.Initializes the BoundField object.

(Geerbt von BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialisiert das angegebene TableCell-Objekt mit dem angegebenen Zeilenzustand.Initializes the specified TableCell object to the specified row state.

(Geerbt von BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

Initialisiert das angegebene DataControlFieldCell-Objekt mit dem angegebenen Zeilenzustand.Initializes the specified DataControlFieldCell object to the specified row state.

LoadViewState(Object)

Stellt die zuvor gespeicherten Ansichtszustandsinformationen für das Feld wieder her.Restores the previously stored view-state information for this field.

(Geerbt von BoundField)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnDataBindField(Object, EventArgs)

Bindet den Wert eines Felds an ein Kontrollkästchen im CheckBoxField-Objekt.Binds the value of a field to a check box in the CheckBoxField object.

OnFieldChanged()

Löst das FieldChanged-Ereignis aus.Raises the FieldChanged event.

(Geerbt von DataControlField)
SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Geerbt von DataControlField)
ToString()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.Returns a string that represents this DataControlField object.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Geerbt von DataControlField)
ValidateSupportsCallback()

Bestimmt, ob die in einem CheckBoxField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen.Determines whether the controls contained in a CheckBoxField object support callbacks.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.Gets or sets the schema associated with this DataControlField object.

(Geerbt von DataControlField)
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Geerbt von DataControlField)
IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.Restores the data control field's previously saved view state.

(Geerbt von DataControlField)
IStateManager.SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Geerbt von DataControlField)

Gilt für:

Siehe auch