ButtonColumn ButtonColumn ButtonColumn ButtonColumn Class

Определение

Тип столбца для элемента управления DataGrid, содержащего пользовательские кнопки.A column type for the DataGrid control that contains a user-defined button.

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 класс DataGrid в элементе управления для создания кнопок добавления .The following code example demonstrates how to use ButtonColumn class in a DataGrid control to create Add buttons.

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 'Page_Init 

Комментарии

Используйте класс в элементе управления, чтобы создать кнопку, которая соответствует каждой строке в DataGrid элементе управления. DataGrid ButtonColumnUse the ButtonColumn class in a DataGrid control to create a button that corresponds with each row in the DataGrid control. Укажите заголовок, отображаемый на кнопках, задав Text свойство.Specify the caption that is displayed in the buttons by setting the Text property. Если задать Text свойство, то все кнопки ButtonColumn в объекте имеют одинаковый заголовок.If you set the Text property, all buttons in the ButtonColumn object share the same caption. Кроме того, можно привязать ButtonColumn кнопки к полю в источнике данных.Alternatively, you can bind the ButtonColumn buttons to a field in a data source. Это позволяет отображать разные заголовки для каждой кнопки.This allows you to display different captions for each button. Значения в указанном поле используются для текстового заголовка.The values in the specified field are used for the text caption. Задайте свойство, чтобы привязать ButtonColumn объект к полю в источнике данных. DataTextFieldSet the DataTextField property to bind the ButtonColumn to a field in a data source.

Можно отформатировать заголовки, отображаемые на кнопках, задав DataTextField для свойства строку форматирования.You can format the captions that are displayed in the buttons by setting the DataTextField property with a formatting string.

Нажатие кнопок в ButtonColumn ItemCommand вызывает событие.Clicking the buttons in the ButtonColumn raises the ItemCommand event. Можно программно управлять действием, выполняемым при нажатии кнопки, предоставляя обработчик событий для ItemCommand события.You can programmatically control the action that is performed when the button is clicked by providing an event handler for the ItemCommand event.

По умолчанию проверка страниц не выполняется при нажатии кнопки в ButtonColumn .By default, page validation is not performed when a button in the ButtonColumn is clicked. Проверка страницы определяет, проходят ли правила проверки, определенные элементом управления проверки, к элементам управления для ввода, связанным с элементом управления проверки на странице.Page validation determines whether the input controls that are associated with a validation control on the page all pass the validation rules that are specified by the validation control. Чтобы выполнить проверку страницы при нажатии кнопки, задайте CausesValidation для trueсвойства значение.To perform page validation when a button is clicked, set the CausesValidation property to true.

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

ButtonColumn() ButtonColumn() ButtonColumn() ButtonColumn()

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

Свойства

ButtonType ButtonType ButtonType ButtonType

Получает или задает тип кнопки, отображаемой в объекте ButtonColumn.Gets or sets the type of button to display in the ButtonColumn object.

CausesValidation CausesValidation CausesValidation CausesValidation

Получает или задает значение, показывающее, выполняется ли проверка при нажатии кнопки в объекте ButtonColumn.Gets or sets a value indicating whether validation is performed when a button in the ButtonColumn object is clicked.

CommandName CommandName CommandName CommandName

Получает или задает строку, представляющую команду, выполняемую при нажатии кнопки в объекте ButtonColumn.Gets or sets a string that represents the command to perform when a button in the ButtonColumn object is clicked.

DataTextField DataTextField DataTextField DataTextField

Получает или задает имя поля источника данных, привязываемого к объекту ButtonColumn.Gets or sets the field name from a data source to bind to the ButtonColumn object.

DataTextFormatString DataTextFormatString DataTextFormatString DataTextFormatString

Получает или задает строку, определяющую формат отображения заголовка для каждой кнопки.Gets or sets the string that specifies the display format for the caption in each button.

DesignMode DesignMode DesignMode DesignMode

Возвращает значение, показывающее, находится ли столбец в режиме конструктора.Gets a value that indicates whether the column is in design mode.

(Inherited from DataGridColumn)
FooterStyle FooterStyle FooterStyle FooterStyle

Возвращает свойства стиля для раздела нижнего колонтитула столбца.Gets the style properties for the footer section of the column.

(Inherited from DataGridColumn)
FooterText FooterText FooterText FooterText

Получает или задает текст, отображаемый в разделе нижнего колонтитула столбца.Gets or sets the text displayed in the footer section of the column.

(Inherited from DataGridColumn)
HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

Получает или задает размещение изображения, отображаемого в разделе нижнего колонтитула столбца.Gets or sets the location of an image to display in the header section of the column.

(Inherited from DataGridColumn)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Возвращает свойства стиля для раздела верхнего колонтитула столбца.Gets the style properties for the header section of the column.

(Inherited from DataGridColumn)
HeaderText HeaderText HeaderText HeaderText

Получает или задает текст, отображаемый в разделе верхнего колонтитула столбца.Gets or sets the text displayed in the header section of the column.

(Inherited from DataGridColumn)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Возвращает значение, указывающее, отслеживает ли столбец изменения состояния представления.Gets a value that indicates whether the column is tracking view state changes.

(Inherited from DataGridColumn)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Возвращает значение, которое определяет, отмечается ли объект DataGridColumn, чтобы сохранить его состояние.Gets a value that determines whether the DataGridColumn object is marked to save its state.

(Inherited from DataGridColumn)
ItemStyle ItemStyle ItemStyle ItemStyle

Возвращает свойства стиля для ячеек столбца.Gets the style properties for the item cells of the column.

(Inherited from DataGridColumn)
Owner Owner Owner Owner

Возвращает элемент управления DataGrid, в который входит данный столбец.Gets the DataGrid control that the column is a member of.

(Inherited from DataGridColumn)
SortExpression SortExpression SortExpression SortExpression

Получает или задает имя поля или выражения, передаваемого методу OnSortCommand(DataGridSortCommandEventArgs), когда столбец выбран для сортировки.Gets or sets the name of the field or expression to pass to the OnSortCommand(DataGridSortCommandEventArgs) method when a column is selected for sorting.

(Inherited from DataGridColumn)
Text Text Text Text

Получает или задает подпись, отображаемую в кнопках объекта ButtonColumn.Gets or sets the caption that is displayed in the buttons of the ButtonColumn object.

ValidationGroup ValidationGroup ValidationGroup ValidationGroup

Получает или задает группу элементов управления проверки, для которых объект ButtonColumn инициирует проверку при обратной передаче.Gets or sets the group of validation controls for which the ButtonColumn object causes validation when it posts back to the server.

ViewState ViewState ViewState ViewState

Возвращает объект StateBag, что позволяет столбцу, полученному из класса DataGridColumn, сохранять свои свойства.Gets the StateBag object that allows a column derived from the DataGridColumn class to store its properties.

(Inherited from DataGridColumn)
Visible Visible Visible Visible

Получает или задает значение, показывающее, является ли столбец видимым в элементе управления DataGrid.Gets or sets a value that indicates whether the column is visible in the DataGrid control.

(Inherited from DataGridColumn)

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
FormatDataTextValue(Object) FormatDataTextValue(Object) FormatDataTextValue(Object) FormatDataTextValue(Object)

Преобразует заданное значение в формат, указанный свойством DataTextFormatString.Converts the specified value to the format that is indicated by the DataTextFormatString property.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
Initialize() Initialize() Initialize() Initialize()

Сбрасывает объект ButtonColumn в исходное состояние.Resets the ButtonColumn object to its initial state.

InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType) InitializeCell(TableCell, Int32, ListItemType)

Возвращает заданную ячейку объекта ButtonColumn в исходное состояние.Resets a cell in the ButtonColumn object to its initial state.

LoadViewState(Object) LoadViewState(Object) LoadViewState(Object) LoadViewState(Object)

Загружает состояние объекта DataGridColumn.Loads the state of the DataGridColumn object.

(Inherited from DataGridColumn)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
OnColumnChanged() OnColumnChanged() OnColumnChanged() OnColumnChanged()

Вызывает метод OnColumnsChanged().Calls the OnColumnsChanged() method.

(Inherited from DataGridColumn)
SaveViewState() SaveViewState() SaveViewState() SaveViewState()

Сохраняет текущее состояние объекта DataGridColumn.Saves the current state of the DataGridColumn object.

(Inherited from DataGridColumn)
ToString() ToString() ToString() ToString()

Возвращает строковое представление столбца.Returns the string representation of the column.

(Inherited from DataGridColumn)
TrackViewState() TrackViewState() TrackViewState() TrackViewState()

Вызывает отслеживание изменений состояния представления серверного элемента управления для сохранения в объекте StateBag серверного элемента управления.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object.

(Inherited from DataGridColumn)

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

IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Загружает сохраненное ранее состояние.Loads previously saved state.

(Inherited from DataGridColumn)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Возвращает объект, содержащий данные об изменении состояния.Returns an object containing state changes.

(Inherited from DataGridColumn)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Запускает отслеживание изменений состояния.Starts tracking state changes.

(Inherited from DataGridColumn)

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

Дополнительно