CheckBoxField Klasa

Definicja

Reprezentuje pole logiczne, które jest wyświetlane jako pole wyboru w kontrolce powiązanej z danymi.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
Dziedziczenie

Przykłady

Poniższy przykład kodu demonstruje, jak używać CheckBoxField obiektu w GridView kontrolce do wyświetlania pola ze źródła danych Microsoft SQL Server z typem danych Boolean.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>

Uwagi

CheckBoxFieldKlasa jest używana przez formanty powiązane z danymi (takie jak GridView i DetailsView ) do wyświetlania wartości pola dane logiczne w polu wyboru.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. CheckBoxFieldObiekt jest wyświetlany inaczej w zależności od kontrolki powiązanej z danymi, w której jest używany.The CheckBoxField object is displayed differently depending on the data-bound control in which it is used. Na przykład GridView kontrolka wyświetla CheckBoxField obiekt jako kolumnę, podczas gdy DetailsView kontrolka wyświetla go jako wiersz.For example, the GridView control displays a CheckBoxField object as a column, while the DetailsView control displays it as a row.

Uwaga

Pole wyboru jest wyłączone (tylko do odczytu), dopóki formant powiązany z danymi nie wyświetli rekordu zawierającego pole wyboru w trybie edycji.A check box is disabled (read-only) until the data-bound control displays a record that contains the check box in edit mode. Aby uzyskać więcej informacji na temat sposobu umieszczania rekordu w trybie edycji, zapoznaj się z dokumentacją kontrolki nadrzędnej zawierającej CheckBoxField obiekt.For more information on how to put a record into edit mode, see the documentation for the parent control that contains the CheckBoxField object.

Aby określić pole, które ma być wyświetlane w CheckBoxField obiekcie, ustaw DataField Właściwość na nazwę pola.To specify the field to display in a CheckBoxField object, set the DataField property with the field's name.

Uwaga

Ponieważ pole wyboru może wyświetlać tylko wybrany lub niezaznaczony stan, CheckBoxField obiekt może być powiązany tylko z polem z typem danych Boolean lub ciągiem, który może być analizowany przez Parse .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.

Możesz wyświetlić podpis obok każdego pola wyboru, ustawiając Text Właściwość.You can display a caption next to each check box by setting the Text property. CheckBoxFieldObiekt jest ukryty w kontrolce powiązanej z danymi, gdy Visible Właściwość jest ustawiona na false .A CheckBoxField object is hidden in a data-bound control when the Visible property is set to false. Aby zapobiec modyfikowaniu wartości pola w trybie edycji, należy ustawić ReadOnly Właściwość na true .To prevent the value of a field from being modified in edit mode, set the ReadOnly property to true. W formantach powiązanych z danymi, które obsługują wstawianie rekordów (takich jak DetailsView kontrolka), można ukryć CheckBoxField obiekt w trybie wstawiania przez ustawienie InsertVisible właściwości na false .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.

Możesz dostosować sekcje nagłówka i stopki CheckBoxField obiektu.You can customize the header and footer sections of a CheckBoxField object. Aby wyświetlić podpis w sekcjach nagłówka lub stopki, ustaw HeaderText FooterText odpowiednio właściwości lub.To display a caption in the header or footer sections, set the HeaderText or FooterText properties, respectively. Zamiast wyświetlania tekstu w sekcji nagłówka, można wyświetlić obraz przez ustawienie HeaderImageUrl właściwości.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. Sekcja nagłówka może być ukryta w CheckBoxField obiekcie przez ustawienie ShowHeader właściwości na false .The header section can be hidden in the CheckBoxField object by setting the ShowHeader property to false.

Uwaga

Niektóre kontrolki powiązane z danymi (takie jak GridView kontrolka) mogą pokazać lub ukryć tylko całą sekcję nagłówka kontrolki.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Te kontrolki powiązane z danymi nie obsługują ShowHeader właściwości dla pojedynczego pola powiązanego.These data-bound controls do not support the ShowHeader property for an individual bound field. Aby pokazać lub ukryć całą sekcję nagłówka kontrolki powiązanej z danymi (jeśli jest dostępna), użyj właściwości kontrolki ShowHeader .To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

Można również dostosować wygląd CheckBoxField obiektu (kolor czcionki, kolor tła itd.) przez ustawienie właściwości stylu dla różnych części pola.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. W poniższej tabeli wymieniono różne właściwości stylu.The following table lists the different style properties.

Style — właściwośćStyle property OpisDescription
ControlStyle Ustawienia stylu dla formantów podrzędnego serwera sieci Web CheckBoxField obiektu.The style settings for the child Web server controls of the CheckBoxField object.
FooterStyle Ustawienia stylu sekcji stopki CheckBoxField obiektu.The style settings for the footer section of the CheckBoxField object.
HeaderStyle Ustawienia stylu sekcji nagłówka CheckBoxField obiektu.The style settings for the header section of the CheckBoxField object.
ItemStyle Ustawienia stylu dla elementów danych w CheckBoxField obiekcie.The style settings for the data items in the CheckBoxField object.

Konstruktory

CheckBoxField()

Inicjuje nowe wystąpienie klasy CheckBoxField.Initializes a new instance of the CheckBoxField class.

Właściwości

AccessibleHeaderText

Pobiera lub ustawia tekst, który jest renderowany jako AbbreviatedText wartość właściwości w niektórych kontrolkach.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Odziedziczone po DataControlField)
ApplyFormatInEditMode

Przesłania ApplyFormatInEditMode Właściwość.Overrides the ApplyFormatInEditMode property. Ta właściwość nie jest obsługiwana przez CheckBoxField klasę.This property is not supported by the CheckBoxField class.

Control

Pobiera odwołanie do kontrolki danych, z którą DataControlField skojarzony jest obiekt.Gets a reference to the data control that the DataControlField object is associated with.

(Odziedziczone po DataControlField)
ControlStyle

Pobiera styl dowolnych kontrolek serwera sieci Web zawartych w DataControlField obiekcie.Gets the style of any Web server controls contained by the DataControlField object.

(Odziedziczone po DataControlField)
ConvertEmptyStringToNull

Przesłania ConvertEmptyStringToNull Właściwość.Overrides the ConvertEmptyStringToNull property. Ta właściwość nie jest obsługiwana przez CheckBoxField klasę.This property is not supported by the CheckBoxField class.

DataField

Pobiera lub ustawia nazwę pola danych, które ma być powiązane z CheckBoxField obiektem.Gets or sets the name of the data field to bind to the CheckBoxField object.

DataFormatString

Pobiera lub ustawia ciąg określający format wyświetlania wartości pola.Gets or sets the string that specifies the display format for the value of the field. Ta właściwość nie jest obsługiwana przez CheckBoxField klasę.This property is not supported by the CheckBoxField class.

DesignMode

Pobiera wartość wskazującą, czy pole kontroli danych jest aktualnie wyświetlane w środowisku czasu projektowania.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Odziedziczone po DataControlField)
FooterStyle

Pobiera lub ustawia styl stopki pola kontrolki danych.Gets or sets the style of the footer of the data control field.

(Odziedziczone po DataControlField)
FooterText

Pobiera lub ustawia tekst, który będzie wyświetlany w elemencie stopki pola kontrolki danych.Gets or sets the text that is displayed in the footer item of a data control field.

(Odziedziczone po DataControlField)
HeaderImageUrl

Pobiera lub ustawia adres URL obrazu, który jest wyświetlany w elemencie nagłówka pola kontrolki danych.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Odziedziczone po DataControlField)
HeaderStyle

Pobiera lub ustawia styl nagłówka pola kontrolki danych.Gets or sets the style of the header of the data control field.

(Odziedziczone po DataControlField)
HeaderText

Pobiera lub ustawia tekst, który będzie wyświetlany w nagłówku kontrolki danych.Gets or sets the text that is displayed in the header of a data control.

(Odziedziczone po BoundField)
HtmlEncode

Przesłania HtmlEncode Właściwość.Overrides the HtmlEncode property. Ta właściwość nie jest obsługiwana przez CheckBoxField klasę.This property is not supported by the CheckBoxField class.

HtmlEncodeFormatString

Pobiera lub ustawia wartość wskazującą, czy sformatowany tekst powinien być kodowany HTML przed wyświetleniem.Gets or sets a value that indicates whether the formatted text should be HTML encoded before it is displayed.

InsertVisible

Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego formant powiązany z danymi nadrzędnymi jest w trybie wstawiania.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Odziedziczone po DataControlField)
IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Odziedziczone po DataControlField)
ItemStyle

Pobiera styl dowolnej zawartości tekstowej wyświetlanej w polu kontrolki danych.Gets the style of any text-based content displayed by a data control field.

(Odziedziczone po DataControlField)
NullDisplayText

Pobiera lub ustawia tekst wyświetlany dla pola, gdy wartość pola to null .Gets or sets the text displayed for a field when the field's value is null. Ta właściwość nie jest obsługiwana przez CheckBoxField klasę.This property is not supported by the CheckBoxField class.

ReadOnly

Pobiera lub ustawia wartość wskazującą, czy wartość pola może być modyfikowana w trybie edycji.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

(Odziedziczone po BoundField)
ShowHeader

Pobiera lub ustawia wartość wskazującą, czy element nagłówka pola kontrolki danych jest renderowany.Gets or sets a value indicating whether the header item of a data control field is rendered.

(Odziedziczone po DataControlField)
SortExpression

Pobiera lub ustawia wyrażenie sortowania, które jest używane przez kontrolkę źródła danych do sortowania danych.Gets or sets a sort expression that is used by a data source control to sort data.

(Odziedziczone po DataControlField)
SupportsHtmlEncode

Pobiera wartość logiczną wskazującą, czy kontrolka obsługuje kodowanie HTML.Gets a Boolean value indicating whether the control supports HTML encoding.

Text

Pobiera lub ustawia napis wyświetlany obok każdego pola wyboru w CheckBoxField obiekcie.Gets or sets the caption to display next to each check box in a CheckBoxField object.

ValidateRequestMode

Pobiera lub ustawia wartość określającą, czy formant sprawdza poprawność danych wejściowych klienta.Gets or sets a value that determines whether the control validates client input or not.

(Odziedziczone po BoundField)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku DataControlField obiektu w wielu żądaniach na tej samej stronie.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.

(Odziedziczone po DataControlField)
Visible

Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane.Gets or sets a value indicating whether a data control field is rendered.

(Odziedziczone po DataControlField)

Metody

CloneField()

Tworzy zduplikowaną kopię bieżącego DataControlField obiektu pochodnego.Creates a duplicate copy of the current DataControlField-derived object.

(Odziedziczone po DataControlField)
CopyProperties(DataControlField)

Kopiuje właściwości bieżącego CheckBoxField obiektu do określonego DataControlField obiektu.Copies the properties of the current CheckBoxField object to the specified DataControlField object.

CreateField()

Tworzy pusty CheckBoxField obiekt.Creates an empty CheckBoxField object.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Wypełnia określony IDictionary obiekt wartościami z określonego DataControlFieldCell obiektu.Fills the specified IDictionary object with the values from the specified DataControlFieldCell object.

FormatDataValue(Object, Boolean)

Formatuje określoną wartość pola dla komórki w BoundField obiekcie.Formats the specified field value for a cell in the BoundField object.

(Odziedziczone po BoundField)
GetDesignTimeValue()

Pobiera wartość użytą dla wartości pola podczas renderowania CheckBoxField obiektu w projektancie.Retrieves the value used for the field's value when rendering the CheckBoxField object in a designer.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
GetValue(Control)

Pobiera wartość pola powiązanego z BoundField obiektem.Retrieves the value of the field bound to the BoundField object.

(Odziedziczone po BoundField)
Initialize(Boolean, Control)

Inicjuje BoundField obiekt.Initializes the BoundField object.

(Odziedziczone po BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Inicjuje określony TableCell obiekt do określonego stanu wiersza.Initializes the specified TableCell object to the specified row state.

(Odziedziczone po BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inicjuje określony DataControlFieldCell obiekt do określonego stanu wiersza.Initializes the specified DataControlFieldCell object to the specified row state.

LoadViewState(Object)

Przywraca poprzednio zapisane informacje o stanie widoku dla tego pola.Restores the previously stored view-state information for this field.

(Odziedziczone po BoundField)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnDataBindField(Object, EventArgs)

Wiąże wartość pola z polem wyboru w CheckBoxField obiekcie.Binds the value of a field to a check box in the CheckBoxField object.

OnFieldChanged()

Podnosi FieldChanged zdarzenie.Raises the FieldChanged event.

(Odziedziczone po DataControlField)
SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od momentu, gdy strona została opublikowana z powrotem na serwerze.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Odziedziczone po DataControlField)
ToString()

Zwraca ciąg, który reprezentuje ten DataControlField obiekt.Returns a string that represents this DataControlField object.

(Odziedziczone po DataControlField)
TrackViewState()

Powoduje, że DataControlField obiekt śledzi zmiany stanu widoku, aby mogły być przechowywane we właściwości kontrolki ViewState i utrwalane między żądaniami dla tej samej strony.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.

(Odziedziczone po DataControlField)
ValidateSupportsCallback()

Określa, czy kontrolki zawarte w CheckBoxField obiekcie obsługują wywołania zwrotne.Determines whether the controls contained in a CheckBoxField object support callbacks.

Jawne implementacje interfejsu

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem.Gets or sets the schema associated with this DataControlField object.

(Odziedziczone po DataControlField)
IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Odziedziczone po DataControlField)
IStateManager.LoadViewState(Object)

Przywraca stan widoku poprzednio zapisanego pola kontroli danych.Restores the data control field's previously saved view state.

(Odziedziczone po DataControlField)
IStateManager.SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od momentu, gdy strona została opublikowana z powrotem na serwerze.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Odziedziczone po DataControlField)
IStateManager.TrackViewState()

Powoduje, że DataControlField obiekt śledzi zmiany stanu widoku, aby mogły być przechowywane we właściwości kontrolki ViewState i utrwalane między żądaniami dla tej samej strony.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.

(Odziedziczone po DataControlField)

Dotyczy

Zobacz też