CheckBoxField Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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: Object

DataControlField

BoundField
CheckBoxField

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

Udostępnij za pośrednictwem

CheckBoxField Klasa

Definicja

Przykłady

Uwagi

Konstruktory

Właściwości

Metody

Jawne implementacje interfejsu

Dotyczy

Zobacz też

Dodatkowe zasoby