CheckBoxField Třída

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje logické pole, které se zobrazuje jako zaškrtávací políčko v ovládacím prvku vázaném na data.

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

Dědičnost: Object

DataControlField

BoundField
CheckBoxField

Příklady

Následující příklad kódu ukazuje použití CheckBoxField objektu v ovládacím GridView prvku k zobrazení pole ze zdroje dat Microsoft SQL Server s logickým datovým typem.


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

Poznámky

Třídu CheckBoxField používají ovládací prvky vázané na data (například GridView a DetailsView) k zobrazení hodnoty logického datového pole v zaškrtávacím políčku. Objekt CheckBoxField se zobrazuje odlišně v závislosti na ovládacím prvku vázaném na data, ve kterém se používá. GridView Například ovládací prvek zobrazí CheckBoxField objekt jako sloupec, zatímco DetailsView ovládací prvek ho zobrazí jako řádek.

Poznámka:

Zaškrtávací políčko je zakázané (jen pro čtení), dokud ovládací prvek vázaný na data nezobrazí záznam, který obsahuje zaškrtávací políčko v režimu úprav. Další informace o tom, jak vložit záznam do režimu úprav, naleznete v dokumentaci nadřazeného ovládacího prvku, který obsahuje CheckBoxField objekt.

Chcete-li zadat pole, které se má zobrazit v objektu CheckBoxField , nastavte DataField vlastnost s názvem pole.

Poznámka:

Protože zaškrtávací políčko může zobrazit pouze vybraný nebo nevybraný stav, CheckBoxField může být objekt vázán pouze na pole s logickým datovým typem nebo řetězcem, který lze analyzovat Parse.

Titulek můžete zobrazit vedle každého zaškrtávacího políčka nastavením Text vlastnosti. Objekt CheckBoxField je skrytý v ovládacím prvku vázaném na data, pokud Visible je vlastnost nastavena na false. Chcete-li zabránit úpravě hodnoty pole v režimu úprav, nastavte ReadOnly vlastnost na true. V ovládacích prvcích vázaných na data, které podporují vkládání záznamů (například DetailsView ovládacího prvku), můžete objekt v režimu vložení skrýt CheckBoxField nastavením InsertVisible vlastnosti na false.

Oddíly záhlaví a zápatí objektu CheckBoxField můžete přizpůsobit. Pokud chcete zobrazit titulek v oddílech záhlaví nebo zápatí, nastavte HeaderText příslušné FooterText vlastnosti. Místo zobrazení textu v oddílu záhlaví můžete obrázek zobrazit nastavením HeaderImageUrl vlastnosti. Oddíl záhlaví může být v objektu CheckBoxField skrytý nastavením ShowHeader vlastnosti na false.

Poznámka:

Některé ovládací prvky vázané na data (například GridView ovládací prvek) můžou zobrazit nebo skrýt pouze celý oddíl záhlaví ovládacího prvku. Tyto ovládací prvky vázané na ShowHeader data nepodporují vlastnost pro jednotlivá vázané pole. Pokud chcete zobrazit nebo skrýt celý oddíl záhlaví ovládacího prvku vázaného na data (pokud je k dispozici), použijte vlastnost ovládacího prvku ShowHeader .

Vzhled objektu CheckBoxField (barva písma, barva pozadí atd.) můžete také přizpůsobit nastavením vlastností stylu pro různé části pole. Následující tabulka uvádí různé vlastnosti stylu.

Vlastnost Style	Description
ControlStyle	Nastavení stylu podřízených ovládacích prvků webového serveru objektu CheckBoxField .
FooterStyle	Nastavení stylu pro oddíl zápatí objektu CheckBoxField .
HeaderStyle	Nastavení stylu pro oddíl záhlaví objektu CheckBoxField .
ItemStyle	Nastavení stylu datových položek v objektu CheckBoxField .

Konstruktory

Name	Description
CheckBoxField()	Inicializuje novou instanci CheckBoxField třídy.

Vlastnosti

Name	Description
AccessibleHeaderText	Získá nebo nastaví text, který je vykreslen jako `AbbreviatedText` hodnota vlastnosti v některých ovládacích prvcích. (Zděděno od DataControlField)
ApplyFormatInEditMode	ApplyFormatInEditMode Přepíše vlastnost. Tato vlastnost není podporována CheckBoxField třídou.
Control	Získá odkaz na ovládací prvek dat, ke kterému DataControlField je objekt přidružen. (Zděděno od DataControlField)
ControlStyle	Získá styl všech ovládacích prvků webového serveru obsažené objektu DataControlField . (Zděděno od DataControlField)
ConvertEmptyStringToNull	ConvertEmptyStringToNull Přepíše vlastnost. Tato vlastnost není podporována CheckBoxField třídou.
DataField	Získá nebo nastaví název datového pole pro vazbu k objektu CheckBoxField .
DataFormatString	Získá nebo nastaví řetězec, který určuje formát zobrazení pro hodnotu pole. Tato vlastnost není podporována CheckBoxField třídou.
DesignMode	Získá hodnotu označující, zda pole ovládacího prvku dat je aktuálně zobrazeno v návrhovém prostředí. (Zděděno od DataControlField)
FooterStyle	Získá nebo nastaví styl zápatí pole ovládacího prvku dat. (Zděděno od DataControlField)
FooterText	Získá nebo nastaví text, který je zobrazen v zápatí položky pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderImageUrl	Získá nebo nastaví adresu URL obrázku, který se zobrazí v položce záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderStyle	Získá nebo nastaví styl záhlaví pole ovládacího prvku dat. (Zděděno od DataControlField)
HeaderText	Získá nebo nastaví text zobrazený v záhlaví ovládacího prvku dat. (Zděděno od BoundField)
HtmlEncode	HtmlEncode Přepíše vlastnost. Tato vlastnost není podporována CheckBoxField třídou.
HtmlEncodeFormatString	Získá nebo nastaví hodnotu, která označuje, zda formátovaný text má být kódován HTML před zobrazením.
InsertVisible	Získá hodnotu určující, zda DataControlField objekt je viditelný, když nadřazený ovládací prvek vázané na data je v režimu vložení. (Zděděno od DataControlField)
IsTrackingViewState	Získá hodnotu určující, zda DataControlField objekt ukládá změny do jeho stavu zobrazení. (Zděděno od DataControlField)
ItemStyle	Získá styl libovolného textového obsahu zobrazeného polem ovládacího prvku dat. (Zděděno od DataControlField)
NullDisplayText	Získá nebo nastaví text zobrazený pro pole, pokud je `null`hodnota pole . Tato vlastnost není podporována CheckBoxField třídou.
ReadOnly	Získá nebo nastaví hodnotu určující, zda hodnotu pole lze upravit v režimu úprav. (Zděděno od BoundField)
ShowHeader	Získá nebo nastaví hodnotu určující, zda je položka záhlaví pole ovládacího prvku dat vykreslena. (Zděděno od DataControlField)
SortExpression	Získá nebo nastaví výraz řazení, který používá ovládací prvek zdroje dat k řazení dat. (Zděděno od DataControlField)
SupportsHtmlEncode	Získá logickou hodnotu označující, zda ovládací prvek podporuje kódování HTML.
Text	Získá nebo nastaví titulek zobrazit vedle každého zaškrtávacího políčka v objektu CheckBoxField .
ValidateRequestMode	Získá nebo nastaví hodnotu, která určuje, zda ovládací prvek ověřuje vstup klienta, nebo ne. (Zděděno od BoundField)
ViewState	Získá slovník informací o stavu, který umožňuje uložit a obnovit stav zobrazení objektu DataControlField napříč více požadavky na stejnou stránku. (Zděděno od DataControlField)
Visible	Získá nebo nastaví hodnotu určující, zda je pole ovládacího prvku dat vykresleno. (Zděděno od DataControlField)

Metody

Name	Description
CloneField()	Vytvoří duplicitní kopii aktuálního DataControlFieldodvozeného objektu. (Zděděno od DataControlField)
CopyProperties(DataControlField)	Zkopíruje vlastnosti aktuálního CheckBoxField objektu do zadaného DataControlField objektu.
CreateField()	Vytvoří prázdný CheckBoxField objekt.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Vyplní zadaný IDictionary objekt hodnotami ze zadaného DataControlFieldCell objektu.
FormatDataValue(Object, Boolean)	Naformátuje zadanou hodnotu pole pro buňku v objektu BoundField . (Zděděno od BoundField)
GetDesignTimeValue()	Načte hodnotu použitou pro hodnotu pole při vykreslování CheckBoxField objektu v návrháři.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetValue(Control)	Načte hodnotu pole vázaného na BoundField objekt. (Zděděno od BoundField)
Initialize(Boolean, Control)	Inicializuje BoundField objekt. (Zděděno od BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)	Inicializuje zadaný TableCell objekt do zadaného stavu řádku. (Zděděno od BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)	Inicializuje zadaný DataControlFieldCell objekt do zadaného stavu řádku.
LoadViewState(Object)	Obnoví dříve uložené informace o stavu zobrazení pro toto pole. (Zděděno od BoundField)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnDataBindField(Object, EventArgs)	Vytvoří vazbu hodnoty pole na zaškrtávací políčko v objektu CheckBoxField .
OnFieldChanged()	`FieldChanged` Vyvolá událost. (Zděděno od DataControlField)
SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka odeslána zpět na server. (Zděděno od DataControlField)
ToString()	Vrátí řetězec, který představuje tento DataControlField objekt. (Zděděno od DataControlField)
TrackViewState()	Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)
ValidateSupportsCallback()	Určuje, zda ovládací prvky obsažené v objektu CheckBoxField podporují zpětné volání.

Explicitní implementace rozhraní

Name	Description
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Získá nebo nastaví schéma přidružené k tomuto DataControlField objektu. (Zděděno od DataControlField)
IStateManager.IsTrackingViewState	Získá hodnotu určující, zda DataControlField objekt ukládá změny do jeho stavu zobrazení. (Zděděno od DataControlField)
IStateManager.LoadViewState(Object)	Obnoví dříve uložený stav zobrazení pole ovládacího prvku dat. (Zděděno od DataControlField)
IStateManager.SaveViewState()	Uloží změny provedené ve DataControlField stavu zobrazení od doby, kdy byla stránka odeslána zpět na server. (Zděděno od DataControlField)
IStateManager.TrackViewState()	Způsobí, že DataControlField objekt bude sledovat změny stavu zobrazení, aby je bylo možné uložit do vlastnosti ovládacího prvku ViewState a zachovat v rámci požadavků na stejnou stránku. (Zděděno od DataControlField)

Platí pro

Viz také

Váš názor

Byla tato stránka užitečná?

Sdílet prostřednictvím

CheckBoxField Třída

Definice

Příklady

Poznámky

Konstruktory

Vlastnosti

Metody

Explicitní implementace rozhraní

Platí pro

Viz také

Váš názor