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)

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

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