CheckBoxField Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

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

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

Наследование: Object

DataControlField

BoundField
CheckBoxField

Примеры

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


<%@ 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 объект может быть привязан только к полю с логическим типом 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)

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

CheckBoxField Класс

Определение

Примеры

Комментарии

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

Свойства

Методы

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

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

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

Дополнительные ресурсы