ButtonColumn Класс

Определение

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

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

Важно!

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

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

public ref class ButtonColumn : System::Web::UI::WebControls::DataGridColumn

public class ButtonColumn : System.Web.UI.WebControls.DataGridColumn

type ButtonColumn = class
    inherit DataGridColumn

Public Class ButtonColumn
Inherits DataGridColumn

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

DataGridColumn
ButtonColumn

Примеры

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

private void Page_Init(Object sender, EventArgs e)
{

   // Create dynamic column to add to Columns collection.
   ButtonColumn AddColumn = new ButtonColumn();
   AddColumn.HeaderText="Add Item";
   AddColumn.Text="Add";
   AddColumn.CommandName="Add";
   AddColumn.ButtonType = ButtonColumnType.PushButton;

   // Add column to Columns collection.
   ItemsGrid.Columns.AddAt(2, AddColumn);
}

Private Sub Page_Init(sender As Object, e As EventArgs)
    
    ' Create dynamic column to add to Columns collection.
    Dim AddColumn As New ButtonColumn()
    AddColumn.HeaderText = "Add Item"
    AddColumn.Text = "Add"
    AddColumn.CommandName = "Add"
    AddColumn.ButtonType = ButtonColumnType.PushButton

    
    ' Add column to Columns collection.
    ItemsGrid.Columns.AddAt(2, AddColumn)
End Sub

ButtonColumn Используйте класс в элементе DataGrid управления, чтобы создать кнопку, соответствующую каждой строке DataGrid элемента управления. Укажите подпись, отображаемую Text в кнопках, задав свойство. Если задать Text свойство, все кнопки в объекте ButtonColumn имеют одинаковый заголовок. Кроме того, можно привязать ButtonColumn кнопки к полю в источнике данных. Это позволяет отображать разные подписи для каждой кнопки. Значения в указанном поле используются для заголовка текста. DataTextField Задайте свойство для привязки ButtonColumn поля в источнике данных.

Вы можете отформатировать субтитры, отображаемые на кнопках, задав DataTextField свойство строкой форматирования.

Нажатие кнопок в ButtonColumn вызове ItemCommand события. Вы можете программно контролировать действие, выполняемое при нажатии кнопки, предоставив обработчик событий для ItemCommand события.

По умолчанию проверка страницы не выполняется при нажатии кнопки ButtonColumn . Проверка страницы определяет, передаются ли входные элементы управления, связанные с элементом управления проверки на странице, все правила проверки, указанные элементом управления проверки. Чтобы выполнить проверку страницы при нажатии кнопки, задайте CausesValidation для свойства значение true.

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

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

Свойства

Имя	Описание
ButtonType	Возвращает или задает тип кнопки, отображаемой в объекте ButtonColumn .
CausesValidation	Возвращает или задает значение, указывающее, выполняется ли проверка при нажатии кнопки в объекте ButtonColumn .
CommandName	Возвращает или задает строку, представляющую команду для выполнения при нажатии кнопки в объекте ButtonColumn .
DataTextField	Возвращает или задает имя поля из источника данных для привязки к объекту ButtonColumn .
DataTextFormatString	Возвращает или задает строку, указывающую формат отображения заголовка в каждой кнопке.
DesignMode	Возвращает значение, указывающее, находится ли столбец в режиме конструктора. (Унаследовано от DataGridColumn)
FooterStyle	Возвращает свойства стиля для нижнего колонтитула столбца. (Унаследовано от DataGridColumn)
FooterText	Возвращает или задает текст, отображаемый в нижнем колонтитуле столбца. (Унаследовано от DataGridColumn)
HeaderImageUrl	Возвращает или задает расположение изображения, отображаемого в разделе заголовка столбца. (Унаследовано от DataGridColumn)
HeaderStyle	Возвращает свойства стиля для раздела заголовка столбца. (Унаследовано от DataGridColumn)
HeaderText	Возвращает или задает текст, отображаемый в разделе заголовка столбца. (Унаследовано от DataGridColumn)
IsTrackingViewState	Возвращает значение, определяющее, помечен ли DataGridColumn объект для сохранения состояния. (Унаследовано от DataGridColumn)
ItemStyle	Возвращает свойства стиля для ячеек элемента столбца. (Унаследовано от DataGridColumn)
Owner	DataGrid Возвращает элемент управления, в который входит столбец. (Унаследовано от DataGridColumn)
SortExpression	Возвращает или задает имя поля или выражения, передаваемого OnSortCommand(DataGridSortCommandEventArgs) методу при выборе столбца для сортировки. (Унаследовано от DataGridColumn)
Text	Возвращает или задает заголовок, отображаемый на кнопках ButtonColumn объекта.
ValidationGroup	Возвращает или задает группу элементов управления проверки, для которых ButtonColumn объект вызывает проверку при отправке обратно на сервер.
ViewState	Возвращает объект, позволяющий столбцу StateBag , производным от DataGridColumn класса, хранить его свойства. (Унаследовано от DataGridColumn)
Visible	Возвращает или задает значение, указывающее, отображается ли столбец в элементе DataGrid управления. (Унаследовано от DataGridColumn)

Методы

Имя	Описание
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
FormatDataTextValue(Object)	Преобразует указанное значение в формат, указанный свойством DataTextFormatString .
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
Initialize()	Сбрасывает ButtonColumn объект в исходное состояние.
InitializeCell(TableCell, Int32, ListItemType)	Сбрасывает ячейку ButtonColumn объекта в исходное состояние.
LoadViewState(Object)	Загружает состояние DataGridColumn объекта. (Унаследовано от DataGridColumn)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnColumnChanged()	OnColumnsChanged() Вызывает метод. (Унаследовано от DataGridColumn)
SaveViewState()	Сохраняет текущее состояние DataGridColumn объекта. (Унаследовано от DataGridColumn)
ToString()	Возвращает строковое представление столбца. (Унаследовано от DataGridColumn)
TrackViewState()	Вызывает отслеживание изменений состояния представления в серверном элементе управления, чтобы они могли храниться в объекте серверного элемента управления StateBag . (Унаследовано от DataGridColumn)

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

Имя	Описание
IStateManager.IsTrackingViewState	Возвращает значение, указывающее, изменяется ли столбец в режиме отслеживания состояния. (Унаследовано от DataGridColumn)
IStateManager.LoadViewState(Object)	Загружает ранее сохраненное состояние. (Унаследовано от DataGridColumn)
IStateManager.SaveViewState()	Возвращает объект, содержащий изменения состояния. (Унаследовано от DataGridColumn)
IStateManager.TrackViewState()	Запускает отслеживание изменений состояния. (Унаследовано от DataGridColumn)

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

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

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через