Udostępnij za pośrednictwem


CheckBoxField Klasa

Definicja

Reprezentuje pole logiczne, które jest wyświetlane jako pole wyboru w kontrolce powiązanej z danymi.

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

W poniższym przykładzie kodu pokazano, jak używać CheckBoxField obiektu w kontrolce GridView do wyświetlania pola ze źródła danych Microsoft SQL Server z typem danych logicznym.


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

Klasa CheckBoxField jest używana przez kontrolki powiązane z danymi (takie jak GridView i DetailsView), aby wyświetlić wartość pola danych logicznych w polu wyboru. Obiekt CheckBoxField jest wyświetlany inaczej w zależności od kontrolki powiązanej z danymi, w której jest używany. Na przykład kontrolka GridView wyświetla CheckBoxField obiekt jako kolumnę, a kontrolka DetailsView wyświetla go jako wiersz.

Uwaga

Pole wyboru jest wyłączone (tylko do odczytu), dopóki kontrolka powiązana z danymi nie wyświetli rekordu zawierającego pole wyboru w trybie edycji. Aby uzyskać więcej informacji na temat sposobu umieszczania rekordu w trybie edycji, zobacz dokumentację formantu nadrzędnego zawierającego CheckBoxField obiekt .

Aby określić pole do wyświetlenia w CheckBoxField obiekcie, ustaw DataField właściwość z nazwą pola.

Uwaga

Ponieważ pole wyboru może zawierać tylko wybrany lub niezaznaczony stan, CheckBoxField obiekt może być powiązany tylko z polem z typem danych logicznym lub ciągiem, który może być analizowany przez Parseelement .

Podpis obok każdego pola wyboru można wyświetlić, ustawiając Text właściwość . CheckBoxField Obiekt jest ukryty w kontrolce powiązanej z danymi, gdy właściwość jest ustawiona Visible na falsewartość . Aby zapobiec modyfikacji wartości pola w trybie edycji, ustaw ReadOnly właściwość na truewartość . W kontrolkach powiązanych z danymi, które obsługują wstawianie rekordów (takich jak kontrolka DetailsView ), można ukryć CheckBoxField obiekt w trybie wstawiania, ustawiając InsertVisible właściwość na false.

Sekcje nagłówka CheckBoxField i stopki obiektu można dostosować. Aby wyświetlić podpis w sekcjach nagłówka lub stopki, ustaw HeaderText odpowiednio właściwości lub FooterText . Zamiast wyświetlać tekst w sekcji nagłówka, możesz wyświetlić obraz, ustawiając HeaderImageUrl właściwość . Sekcja nagłówka CheckBoxField może być ukryta w obiekcie, ustawiając ShowHeader właściwość na false.

Uwaga

Niektóre kontrolki powiązane z danymi (takie jak kontrolka GridView ) mogą pokazywać lub ukrywać tylko całą sekcję nagłówka kontrolki. Te kontrolki powiązane z danymi nie obsługują ShowHeader właściwości dla pojedynczego pola powiązanego. Aby wyświetlić lub ukryć całą sekcję nagłówka kontrolki powiązanej z danymi (jeśli jest dostępna), użyj właściwości kontrolki ShowHeader .

Możesz również dostosować wygląd CheckBoxField obiektu (kolor czcionki, kolor tła itd.), ustawiając właściwości stylu dla różnych części pola. W poniższej tabeli wymieniono różne właściwości stylu.

Właściwość Stylu Opis
ControlStyle Ustawienia stylu podrzędnego serwera sieci Web steruje obiektem CheckBoxField .
FooterStyle Ustawienia stylu sekcji CheckBoxField stopki obiektu.
HeaderStyle Ustawienia stylu sekcji nagłówka CheckBoxField obiektu.
ItemStyle Ustawienia stylu elementów danych w CheckBoxField obiekcie.

Konstruktory

CheckBoxField()

Inicjuje nowe wystąpienie klasy CheckBoxField.

Właściwości

AccessibleHeaderText

Pobiera lub ustawia tekst renderowany jako AbbreviatedText wartość właściwości w niektórych kontrolkach.

(Odziedziczone po DataControlField)
ApplyFormatInEditMode

ApplyFormatInEditMode Zastępuje właściwość . Ta właściwość nie jest obsługiwana przez klasę CheckBoxField .

Control

Pobiera odwołanie do kontrolki danych skojarzonej DataControlField z obiektem.

(Odziedziczone po DataControlField)
ControlStyle

Pobiera styl wszystkich kontrolek serwera sieci Web zawartych w DataControlField obiekcie.

(Odziedziczone po DataControlField)
ConvertEmptyStringToNull

ConvertEmptyStringToNull Zastępuje właściwość . Ta właściwość nie jest obsługiwana przez klasę CheckBoxField .

DataField

Pobiera lub ustawia nazwę pola danych, które ma być powiązane z obiektem CheckBoxField .

DataFormatString

Pobiera lub ustawia ciąg określający format wyświetlania wartości pola. Ta właściwość nie jest obsługiwana przez klasę CheckBoxField .

DesignMode

Pobiera wartość wskazującą, czy pole kontrolki danych jest obecnie wyświetlane w środowisku czasu projektowania.

(Odziedziczone po DataControlField)
FooterStyle

Pobiera lub ustawia styl stopki pola kontrolki danych.

(Odziedziczone po DataControlField)
FooterText

Pobiera lub ustawia tekst wyświetlany w elemencie stopki pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderImageUrl

Pobiera lub ustawia adres URL obrazu wyświetlanego w elemencie nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderStyle

Pobiera lub ustawia styl nagłówka pola kontrolki danych.

(Odziedziczone po DataControlField)
HeaderText

Pobiera lub ustawia tekst wyświetlany w nagłówku kontrolki danych.

(Odziedziczone po BoundField)
HtmlEncode

HtmlEncode Zastępuje właściwość . Ta właściwość nie jest obsługiwana przez klasę CheckBoxField .

HtmlEncodeFormatString

Pobiera lub ustawia wartość wskazującą, czy sformatowany tekst powinien być zakodowany w formacie HTML przed jego wyświetleniem.

InsertVisible

Pobiera wartość wskazującą, czy DataControlField obiekt jest widoczny, gdy jego nadrzędna kontrolka związana z danymi jest w trybie wstawiania.

(Odziedziczone po DataControlField)
IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po DataControlField)
ItemStyle

Pobiera styl dowolnej zawartości tekstowej wyświetlanej przez pole kontrolki danych.

(Odziedziczone po DataControlField)
NullDisplayText

Pobiera lub ustawia tekst wyświetlany dla pola, gdy wartość pola to null. Ta właściwość nie jest obsługiwana przez klasę CheckBoxField .

ReadOnly

Pobiera lub ustawia wartość wskazującą, czy wartość pola można zmodyfikować w trybie edycji.

(Odziedziczone po BoundField)
ShowHeader

Pobiera lub ustawia wartość wskazującą, czy element nagłówka pola kontrolki danych jest renderowany.

(Odziedziczone po DataControlField)
SortExpression

Pobiera lub ustawia wyrażenie sortowania używane przez kontrolkę źródła danych do sortowania danych.

(Odziedziczone po DataControlField)
SupportsHtmlEncode

Pobiera wartość logiczną wskazującą, czy kontrolka obsługuje kodowanie HTML.

Text

Pobiera lub ustawia podpis do wyświetlenia obok każdego pola wyboru w CheckBoxField obiekcie.

ValidateRequestMode

Pobiera lub ustawia wartość, która określa, czy kontrolka weryfikuje dane wejściowe klienta, czy nie.

(Odziedziczone po BoundField)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu DataControlField widoku obiektu na wielu żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)
Visible

Pobiera lub ustawia wartość wskazującą, czy pole kontrolki danych jest renderowane.

(Odziedziczone po DataControlField)

Metody

CloneField()

Tworzy zduplikowaną kopię bieżącego DataControlFieldobiektu pochodnego.

(Odziedziczone po DataControlField)
CopyProperties(DataControlField)

Kopiuje właściwości bieżącego CheckBoxField obiektu do określonego DataControlField obiektu.

CreateField()

Tworzy pusty CheckBoxField obiekt.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

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

Wypełnia określony IDictionary obiekt wartościami z określonego DataControlFieldCell obiektu.

FormatDataValue(Object, Boolean)

Formatuje określoną wartość pola dla komórki w BoundField obiekcie.

(Odziedziczone po BoundField)
GetDesignTimeValue()

Pobiera wartość używaną dla wartości pola podczas renderowania CheckBoxField obiektu w projektancie.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
GetValue(Control)

Pobiera wartość pola powiązanego z obiektem BoundField .

(Odziedziczone po BoundField)
Initialize(Boolean, Control)

Inicjuje BoundField obiekt.

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

Inicjuje określony TableCell obiekt do określonego stanu wiersza.

(Odziedziczone po BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

Inicjuje określony DataControlFieldCell obiekt do określonego stanu wiersza.

LoadViewState(Object)

Przywraca wcześniej przechowywane informacje o stanie widoku dla tego pola.

(Odziedziczone po BoundField)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnDataBindField(Object, EventArgs)

Tworzy powiązanie wartości pola z polem wyboru w CheckBoxField obiekcie .

OnFieldChanged()

FieldChanged Zgłasza zdarzenie.

(Odziedziczone po DataControlField)
SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po DataControlField)
ToString()

Zwraca ciąg reprezentujący ten DataControlField obiekt.

(Odziedziczone po DataControlField)
TrackViewState()

DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)
ValidateSupportsCallback()

Określa, czy kontrolki zawarte w CheckBoxField obiekcie obsługują wywołania zwrotne.

Jawne implementacje interfejsu

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Pobiera lub ustawia schemat skojarzony z tym DataControlField obiektem.

(Odziedziczone po DataControlField)
IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy DataControlField obiekt zapisuje zmiany w stanie widoku.

(Odziedziczone po DataControlField)
IStateManager.LoadViewState(Object)

Przywraca wcześniej zapisany stan widoku pola kontroli danych.

(Odziedziczone po DataControlField)
IStateManager.SaveViewState()

Zapisuje zmiany wprowadzone w DataControlField stanie widoku od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po DataControlField)
IStateManager.TrackViewState()

DataControlField Powoduje, że obiekt będzie śledzić zmiany w stanie widoku, dzięki czemu można je przechowywać we właściwości kontrolki ViewState i utrwalać w żądaniach dla tej samej strony.

(Odziedziczone po DataControlField)

Dotyczy

Zobacz też