CheckBoxField Класс

Определение

Представляет поле логического значения, которое отображается как флажок в элементе управления с привязкой к данным.

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
Наследование

Примеры

в следующем примере кода показано, как использовать CheckBoxField объект в GridView элементе управления для отображения поля из источника данных Microsoft SQL Server с типом данных Boolean.


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

Комментарии

CheckBoxFieldКласс используется элементами управления с привязкой к данным (например GridView , и DetailsView ) для вывода значения поля логических данных в флажок. CheckBoxFieldОбъект отображается по-разному в зависимости от привязанного к данным элемента управления, в котором он используется. Например, GridView элемент управления отображает CheckBoxField объект как столбец, а DetailsView элемент управления отображает его как строку.

Примечание

Флажок отключен (только для чтения), пока элемент управления с привязкой к данным не отобразит запись, содержащую флажок в режиме редактирования. Дополнительные сведения о том, как перевести запись в режим редактирования, см. в документации по родительскому элементу управления, содержащему CheckBoxField объект.

Чтобы указать поле, отображаемое в CheckBoxField объекте, задайте для DataField свойства имя поля.

Примечание

Поскольку флажок может отображать только выбранное или невыбранное состояние, CheckBoxField объект может быть привязан только к полю с типом данных Boolean или со строкой, которую можно проанализировать Parse .

Можно отобразить заголовок рядом с каждым флажком, задав Text свойство. CheckBoxFieldОбъект скрыт в элементе управления с привязкой к данным, если Visible свойство имеет значение false . Чтобы запретить изменение значения поля в режиме редактирования, задайте ReadOnly для свойства значение true . В элементах управления с привязкой к данным, поддерживающих вставку записей (например, DetailsView элемент управления), можно скрыть CheckBoxField объект в режиме вставки, задав InsertVisible для свойства значение false .

Можно настроить разделы верхнего и нижнего колонтитула CheckBoxField объекта. Чтобы отобразить заголовок в разделах верхнего или нижнего колонтитула, задайте HeaderText свойства или FooterText соответственно. Вместо отображения текста в разделе заголовка можно отобразить изображение, задав HeaderImageUrl свойство. Раздел заголовка можно скрыть в CheckBoxField объекте, задав ShowHeader свойству значение false .

Примечание

Некоторые элементы управления с привязкой к данным (например, GridView элемент управления) могут отображать или скрывать только весь раздел заголовка элемента управления. Эти элементы управления с привязкой к данным не поддерживают ShowHeader свойство для отдельного привязанного поля. Чтобы показать или скрыть весь раздел заголовка элемента управления с привязкой к данным (если он доступен), используйте свойство элемента управления ShowHeader .

Можно также настроить внешний вид CheckBoxField объекта (цвет шрифта, цвет фона и т. д.), задав свойства стиля для различных частей поля. В следующей таблице перечислены различные свойства стиля.

Свойство Style Описание
ControlStyle Параметры стиля для дочерних серверных веб-элементов управления CheckBoxField объекта.
FooterStyle Параметры стиля для нижнего колонтитула CheckBoxField объекта.
HeaderStyle Параметры стиля для раздела заголовка CheckBoxField объекта.
ItemStyle Параметры стиля для элементов данных в CheckBoxField объекте.

Конструкторы

CheckBoxField()

Инициализирует новый экземпляр класса CheckBoxField.

Свойства

AccessibleHeaderText

Возвращает или задает текст, отображающийся как значение свойство AbbreviatedText некоторых элементов управления.

(Унаследовано от DataControlField)
ApplyFormatInEditMode

Переопределяет свойство ApplyFormatInEditMode. Данное свойство не поддерживается классом CheckBoxField.

Control

Возвращает ссылку на элемент управления данными, с которым связан объект DataControlField.

(Унаследовано от DataControlField)
ControlStyle

Получает стиль любых серверных веб-элементов управления, содержащихся в объекте DataControlField.

(Унаследовано от DataControlField)
ConvertEmptyStringToNull

Переопределяет свойство ConvertEmptyStringToNull. Данное свойство не поддерживается классом CheckBoxField.

DataField

Возвращает или задает имя поля данных, привязываемого к объекту CheckBoxField.

DataFormatString

Получает или задает строку, определяющую формат отображения значения поля. Данное свойство не поддерживается классом CheckBoxField.

DesignMode

Возвращает значение, указывающее, просматривается ли в данный момент поле элемента управления данными в среде режима разработки.

(Унаследовано от DataControlField)
FooterStyle

Возвращает или задает стиль нижнего колонтитула поля элемента управления данными.

(Унаследовано от DataControlField)
FooterText

Возвращает или задает текст для отображения в нижнем колонтитуле поля элемента управления данными.

(Унаследовано от DataControlField)
HeaderImageUrl

Возвращает или задает URL -адрес изображения для отображения в верхнем колонтитуле поля элемента управления данными.

(Унаследовано от DataControlField)
HeaderStyle

Возвращает или задает стиль верхнего колонтитула поля элемента управления данными.

(Унаследовано от DataControlField)
HeaderText

Возвращает или задает текст для отображения в верхнем колонтитуле элемента управления данными.

(Унаследовано от BoundField)
HtmlEncode

Переопределяет свойство HtmlEncode. Данное свойство не поддерживается классом CheckBoxField.

HtmlEncodeFormatString

Получает или задает значение, указывающее, необходимо ли кодирование форматированного текста в формате HTML перед отображением.

InsertVisible

Возвращает значение, указывающее состояние отображения объекта DataControlField во время пребывания его родительского элемента управления, привязанного к данным, в режиме вставки.

(Унаследовано от DataControlField)
IsTrackingViewState

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.

(Унаследовано от DataControlField)
ItemStyle

Возвращает стиль любого текстового содержимого, отображаемого полем элемента управления содержанием.

(Унаследовано от DataControlField)
NullDisplayText

Получает или задает текст, отображаемый в поле, имеющем значение null. Данное свойство не поддерживается классом CheckBoxField.

ReadOnly

Возвращает или задает значение, позволяющее определить, можно ли менять значения поля, в режиме редактирования.

(Унаследовано от BoundField)
ShowHeader

Возвращает или задает значение, указывающее на необходимость отображения верхнего колонтитула для поля элемента управления данными.

(Унаследовано от DataControlField)
SortExpression

Возвращает или задает выражение сортировки, используемое элементом управления источником данных для сортировки данных.

(Унаследовано от DataControlField)
SupportsHtmlEncode

Возвращает логическое значение, показывающее, поддерживает ли элемент управления кодирование в формате HTML.

Text

Получает или задает подпись к каждому флажку в объекте CheckBoxField.

ValidateRequestMode

Получает или задает значение, указывающее, проверяет ли элемент управления клиентский ввод.

(Унаследовано от BoundField)
ViewState

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта DataControlField при нескольких запросах одной и той же страницы.

(Унаследовано от DataControlField)
Visible

Возвращает или задает значение, определяющее, отображается ли поле элемента управления данными.

(Унаследовано от DataControlField)

Методы

CloneField()

Создает точную копию текущего объекта, производного от DataControlField.

(Унаследовано от DataControlField)
CopyProperties(DataControlField)

Копирует свойства текущего объекта CheckBoxField в указанный объект DataControlField.

CreateField()

Создает пустой объект CheckBoxField.

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Заполняет указанный объект IDictionary значениями из указанного объекта DataControlFieldCell.

FormatDataValue(Object, Boolean)

Форматирует указанное значение поля для ячейки в объекте BoundField.

(Унаследовано от BoundField)
GetDesignTimeValue()

Возвращает значение, используемое для значения поля при отрисовке объекта CheckBoxField в конструкторе.

GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
GetValue(Control)

Извлекает значения поля, привязанного к объекту BoundField.

(Унаследовано от BoundField)
Initialize(Boolean, Control)

Выполняет инициализацию объекта BoundField.

(Унаследовано от BoundField)
InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Инициализирует указанный объект TableCell заданным состоянием строки.

(Унаследовано от BoundField)
InitializeDataCell(DataControlFieldCell, DataControlRowState)

Инициализирует указанный объект DataControlFieldCell заданным состоянием строки.

LoadViewState(Object)

Восстанавливает сохраненное раннее состояние просмотра для данного поля.

(Унаследовано от BoundField)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
OnDataBindField(Object, EventArgs)

Привязывает значение поля к флажку в объекте CheckBoxField.

OnFieldChanged()

Вызывает событие FieldChanged.

(Унаследовано от DataControlField)
SaveViewState()

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.

(Унаследовано от DataControlField)
ToString()

Возврат строки, представляющей объект DataControlField.

(Унаследовано от DataControlField)
TrackViewState()

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.

(Унаследовано от DataControlField)
ValidateSupportsCallback()

Определяет поддержку обратных вызовов элементами управления, содержащимися в объекте CheckBoxField.

Явные реализации интерфейса

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Возвращает или задает схему, связанную с этим объектом DataControlField.

(Унаследовано от DataControlField)
IStateManager.IsTrackingViewState

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.

(Унаследовано от DataControlField)
IStateManager.LoadViewState(Object)

Восстанавливает сохраненное раннее состояние представления поля источника данных.

(Унаследовано от DataControlField)
IStateManager.SaveViewState()

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.

(Унаследовано от DataControlField)
IStateManager.TrackViewState()

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.

(Унаследовано от DataControlField)

Применяется к

См. также раздел