CheckBoxField Класс

Определение

Представляет поле логического значения, которое отображается как флажок в элементе управления с привязкой к данным.Represents a Boolean field that is displayed as a check box in a data-bound control.

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.The following code example demonstrates how to use a CheckBoxField object in a GridView control to display a field from a Microsoft SQL Server data source with a Boolean data type.


<%@ 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 ) для вывода значения поля логических данных в флажок.The CheckBoxField class is used by data-bound controls (such as GridView and DetailsView) to display the value of a Boolean data field in a check box. CheckBoxFieldОбъект отображается по-разному в зависимости от привязанного к данным элемента управления, в котором он используется.The CheckBoxField object is displayed differently depending on the data-bound control in which it is used. Например, GridView элемент управления отображает CheckBoxField объект как столбец, а DetailsView элемент управления отображает его как строку.For example, the GridView control displays a CheckBoxField object as a column, while the DetailsView control displays it as a row.

Примечание

Флажок отключен (только для чтения), пока элемент управления с привязкой к данным не отобразит запись, содержащую флажок в режиме редактирования.A check box is disabled (read-only) until the data-bound control displays a record that contains the check box in edit mode. Дополнительные сведения о том, как перевести запись в режим редактирования, см. в документации по родительскому элементу управления, содержащему CheckBoxField объект.For more information on how to put a record into edit mode, see the documentation for the parent control that contains the CheckBoxField object.

Чтобы указать поле, отображаемое в CheckBoxField объекте, задайте для DataField свойства имя поля.To specify the field to display in a CheckBoxField object, set the DataField property with the field's name.

Примечание

Поскольку флажок может отображать только выбранное или невыбранное состояние, CheckBoxField объект может быть привязан только к полю с типом данных Boolean или со строкой, которую можно проанализировать Parse .Because a check box can display only a selected or an unselected state, a CheckBoxField object can be bound only to a field with a Boolean data type or a string that can be parsed by Parse.

Можно отобразить заголовок рядом с каждым флажком, задав Text свойство.You can display a caption next to each check box by setting the Text property. CheckBoxFieldОбъект скрыт в элементе управления с привязкой к данным, если Visible свойство имеет значение false .A CheckBoxField object is hidden in a data-bound control when the Visible property is set to false. Чтобы запретить изменение значения поля в режиме редактирования, задайте ReadOnly для свойства значение true .To prevent the value of a field from being modified in edit mode, set the ReadOnly property to true. В элементах управления с привязкой к данным, поддерживающих вставку записей (например, DetailsView элемент управления), можно скрыть CheckBoxField объект в режиме вставки, задав InsertVisible для свойства значение false .In data-bound controls that support inserting records (such as the DetailsView control), you can hide a CheckBoxField object in insert mode by setting the InsertVisible property to false.

Можно настроить разделы верхнего и нижнего колонтитула CheckBoxField объекта.You can customize the header and footer sections of a CheckBoxField object. Чтобы отобразить заголовок в разделах верхнего или нижнего колонтитула, задайте HeaderText свойства или FooterText соответственно.To display a caption in the header or footer sections, set the HeaderText or FooterText properties, respectively. Вместо отображения текста в разделе заголовка можно отобразить изображение, задав HeaderImageUrl свойство.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. Раздел заголовка можно скрыть в CheckBoxField объекте, задав ShowHeader свойству значение false .The header section can be hidden in the CheckBoxField object by setting the ShowHeader property to false.

Примечание

Некоторые элементы управления с привязкой к данным (например, GridView элемент управления) могут отображать или скрывать только весь раздел заголовка элемента управления.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Эти элементы управления с привязкой к данным не поддерживают ShowHeader свойство для отдельного привязанного поля.These data-bound controls do not support the ShowHeader property for an individual bound field. Чтобы показать или скрыть весь раздел заголовка элемента управления с привязкой к данным (если он доступен), используйте свойство элемента управления ShowHeader .To show or hide the entire header section of a data-bound control (if available), use the control's ShowHeader property.

Можно также настроить внешний вид CheckBoxField объекта (цвет шрифта, цвет фона и т. д.), задав свойства стиля для различных частей поля.You also can customize the appearance of the CheckBoxField object (font color, background color, and so on) by setting the style properties for the different parts of the field. В следующей таблице перечислены различные свойства стиля.The following table lists the different style properties.

Свойство StyleStyle property Описание:Description
ControlStyle Параметры стиля для дочерних серверных веб-элементов управления CheckBoxField объекта.The style settings for the child Web server controls of the CheckBoxField object.
FooterStyle Параметры стиля для нижнего колонтитула CheckBoxField объекта.The style settings for the footer section of the CheckBoxField object.
HeaderStyle Параметры стиля для раздела заголовка CheckBoxField объекта.The style settings for the header section of the CheckBoxField object.
ItemStyle Параметры стиля для элементов данных в CheckBoxField объекте.The style settings for the data items in the CheckBoxField object.

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

CheckBoxField()

Инициализирует новый экземпляр класса CheckBoxField.Initializes a new instance of the CheckBoxField class.

Свойства

AccessibleHeaderText

Возвращает или задает текст, отображающийся как значение свойство AbbreviatedText некоторых элементов управления.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

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

Переопределяет свойство ApplyFormatInEditMode.Overrides the ApplyFormatInEditMode property. Данное свойство не поддерживается классом CheckBoxField.This property is not supported by the CheckBoxField class.

Control

Возвращает ссылку на элемент управления данными, с которым связан объект DataControlField.Gets a reference to the data control that the DataControlField object is associated with.

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

Получает стиль любых серверных веб-элементов управления, содержащихся в объекте DataControlField.Gets the style of any Web server controls contained by the DataControlField object.

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

Переопределяет свойство ConvertEmptyStringToNull.Overrides the ConvertEmptyStringToNull property. Данное свойство не поддерживается классом CheckBoxField.This property is not supported by the CheckBoxField class.

DataField

Возвращает или задает имя поля данных, привязываемого к объекту CheckBoxField.Gets or sets the name of the data field to bind to the CheckBoxField object.

DataFormatString

Получает или задает строку, определяющую формат отображения значения поля.Gets or sets the string that specifies the display format for the value of the field. Данное свойство не поддерживается классом CheckBoxField.This property is not supported by the CheckBoxField class.

DesignMode

Возвращает значение, указывающее, просматривается ли в данный момент поле элемента управления данными в среде режима разработки.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

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

Возвращает или задает стиль нижнего колонтитула поля элемента управления данными.Gets or sets the style of the footer of the data control field.

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

Возвращает или задает текст для отображения в нижнем колонтитуле поля элемента управления данными.Gets or sets the text that is displayed in the footer item of a data control field.

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

Возвращает или задает URL -адрес изображения для отображения в верхнем колонтитуле поля элемента управления данными.Gets or sets the URL of an image that is displayed in the header item of a data control field.

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

Возвращает или задает стиль верхнего колонтитула поля элемента управления данными.Gets or sets the style of the header of the data control field.

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

Возвращает или задает текст для отображения в верхнем колонтитуле элемента управления данными.Gets or sets the text that is displayed in the header of a data control.

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

Переопределяет свойство HtmlEncode.Overrides the HtmlEncode property. Данное свойство не поддерживается классом CheckBoxField.This property is not supported by the CheckBoxField class.

HtmlEncodeFormatString

Получает или задает значение, указывающее, необходимо ли кодирование форматированного текста в формате HTML перед отображением.Gets or sets a value that indicates whether the formatted text should be HTML encoded before it is displayed.

InsertVisible

Возвращает значение, указывающее состояние отображения объекта DataControlField во время пребывания его родительского элемента управления, привязанного к данным, в режиме вставки.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

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

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.Gets a value indicating whether the DataControlField object is saving changes to its view state.

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

Возвращает стиль любого текстового содержимого, отображаемого полем элемента управления содержанием.Gets the style of any text-based content displayed by a data control field.

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

Получает или задает текст, отображаемый в поле, имеющем значение null.Gets or sets the text displayed for a field when the field's value is null. Данное свойство не поддерживается классом CheckBoxField.This property is not supported by the CheckBoxField class.

ReadOnly

Возвращает или задает значение, позволяющее определить, можно ли менять значения поля, в режиме редактирования.Gets or sets a value indicating whether the value of the field can be modified in edit mode.

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

Возвращает или задает значение, указывающее на необходимость отображения верхнего колонтитула для поля элемента управления данными.Gets or sets a value indicating whether the header item of a data control field is rendered.

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

Возвращает или задает выражение сортировки, используемое элементом управления источником данных для сортировки данных.Gets or sets a sort expression that is used by a data source control to sort data.

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

Возвращает логическое значение, показывающее, поддерживает ли элемент управления кодирование в формате HTML.Gets a Boolean value indicating whether the control supports HTML encoding.

Text

Получает или задает подпись к каждому флажку в объекте CheckBoxField.Gets or sets the caption to display next to each check box in a CheckBoxField object.

ValidateRequestMode

Получает или задает значение, указывающее, проверяет ли элемент управления клиентский ввод.Gets or sets a value that determines whether the control validates client input or not.

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

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления объекта DataControlField при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

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

Возвращает или задает значение, определяющее, отображается ли поле элемента управления данными.Gets or sets a value indicating whether a data control field is rendered.

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

Методы

CloneField()

Создает точную копию текущего объекта, производного от DataControlField.Creates a duplicate copy of the current DataControlField-derived object.

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

Копирует свойства текущего объекта CheckBoxField в указанный объект DataControlField.Copies the properties of the current CheckBoxField object to the specified DataControlField object.

CreateField()

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

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Заполняет указанный объект IDictionary значениями из указанного объекта DataControlFieldCell.Fills the specified IDictionary object with the values from the specified DataControlFieldCell object.

FormatDataValue(Object, Boolean)

Форматирует указанное значение поля для ячейки в объекте BoundField.Formats the specified field value for a cell in the BoundField object.

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

Возвращает значение, используемое для значения поля при отрисовке объекта CheckBoxField в конструкторе.Retrieves the value used for the field's value when rendering the CheckBoxField object in a designer.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

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

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

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

Извлекает значения поля, привязанного к объекту BoundField.Retrieves the value of the field bound to the BoundField object.

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

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

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

Инициализирует указанный объект TableCell заданным состоянием строки.Initializes the specified TableCell object to the specified row state.

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

Инициализирует указанный объект DataControlFieldCell заданным состоянием строки.Initializes the specified DataControlFieldCell object to the specified row state.

LoadViewState(Object)

Восстанавливает сохраненное раннее состояние просмотра для данного поля.Restores the previously stored view-state information for this field.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Привязывает значение поля к флажку в объекте CheckBoxField.Binds the value of a field to a check box in the CheckBoxField object.

OnFieldChanged()

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

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

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

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

Возврат строки, представляющей объект DataControlField.Returns a string that represents this DataControlField object.

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

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

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

Определяет поддержку обратных вызовов элементами управления, содержащимися в объекте CheckBoxField.Determines whether the controls contained in a CheckBoxField object support callbacks.

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

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Возвращает или задает схему, связанную с этим объектом DataControlField.Gets or sets the schema associated with this DataControlField object.

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

Получает значение, указывающее сохраняет ли объект DataControlField изменения в данных о состоянии представления.Gets a value indicating whether the DataControlField object is saving changes to its view state.

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

Восстанавливает сохраненное раннее состояние представления поля источника данных.Restores the data control field's previously saved view state.

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

Сохраняет изменения в состояние объекта DataControlField после того, как страница отправлена на сервер.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

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

Инициирует отслеживание объектом DataControlField изменений в состоянии его представления, благодаря чему эти изменения можно сохранить в свойстве элемента ViewState элемента управления и хранить их для всех запросов одной и той же страницы.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

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

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

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