ButtonColumn Класс

Определение

Тип столбца для элемента управления 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
Наследование
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 для свойства строку форматирования.

Нажатие кнопок в вызывает ButtonColumnItemCommand событие . Вы можете программно управлять действием, которое выполняется при нажатии кнопки, предоставив обработчик 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)

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

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