ButtonColumn Klasa

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.dll

Typ kolumny kontrolki DataGrid zawierającej przycisk zdefiniowany przez użytkownika.

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

Dziedziczenie

Object

DataGridColumn

ButtonColumn

Przykłady

W poniższym przykładzie kodu pokazano, jak używać ButtonColumn klasy w kontrolce w celu utworzenia DataGrid przycisków Dodaj .

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

Uwagi

ButtonColumn Użyj klasy w kontrolceDataGrid, aby utworzyć przycisk odpowiadający każdemu wierszowi w kontrolceDataGrid. Określ podpis wyświetlane w przyciskach, ustawiając Text właściwość . Jeśli właściwość zostanie ustawionaText, wszystkie przyciski w ButtonColumn obiekcie mają ten sam podpis. Możesz też powiązać ButtonColumn przyciski z polem w źródle danych. Dzięki temu można wyświetlać różne podpisy dla każdego przycisku. Wartości w określonym polu są używane dla podpis tekstu. DataTextField Ustaw właściwość, aby powiązać ButtonColumn pole z polem w źródle danych.

Podpisy wyświetlane w przyciskach można sformatować, ustawiając DataTextField właściwość za pomocą ciągu formatowania.

Kliknięcie przycisków w obiekcie ButtonColumn powoduje podniesienie ItemCommand zdarzenia. Możesz programowo kontrolować akcję wykonywaną po kliknięciu przycisku, podając procedurę obsługi zdarzeń ItemCommand dla zdarzenia.

Domyślnie walidacja strony nie jest wykonywana po kliknięciu przycisku w obiekcie ButtonColumn . Sprawdzanie poprawności strony określa, czy kontrolki wejściowe skojarzone z kontrolką walidacji na stronie przechodzą wszystkie reguły sprawdzania poprawności określone przez kontrolkę walidacji. Aby przeprowadzić walidację strony po kliknięciu CausesValidation przycisku, ustaw właściwość na true.

Konstruktory

ButtonColumn()

Inicjuje nowe wystąpienie klasy ButtonColumn.

Właściwości

ButtonType	Pobiera lub ustawia typ przycisku do wyświetlenia w ButtonColumn obiekcie.
CausesValidation	Pobiera lub ustawia wartość wskazującą, czy walidacja jest wykonywana po kliknięciu ButtonColumn przycisku w obiekcie.
CommandName	Pobiera lub ustawia ciąg reprezentujący polecenie do wykonania po kliknięciu ButtonColumn przycisku w obiekcie.
DataTextField	Pobiera lub ustawia nazwę pola ze źródła danych w celu powiązania z obiektem ButtonColumn .
DataTextFormatString	Pobiera lub ustawia ciąg określający format wyświetlania dla podpis w każdym przycisku.
DesignMode	Pobiera wartość wskazującą, czy kolumna jest w trybie projektowania. (Odziedziczone po DataGridColumn)
FooterStyle	Pobiera właściwości stylu dla sekcji stopki kolumny. (Odziedziczone po DataGridColumn)
FooterText	Pobiera lub ustawia tekst wyświetlany w sekcji stopki kolumny. (Odziedziczone po DataGridColumn)
HeaderImageUrl	Pobiera lub ustawia lokalizację obrazu do wyświetlenia w sekcji nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderStyle	Pobiera właściwości stylu dla sekcji nagłówka kolumny. (Odziedziczone po DataGridColumn)
HeaderText	Pobiera lub ustawia tekst wyświetlany w sekcji nagłówka kolumny. (Odziedziczone po DataGridColumn)
IsTrackingViewState	Pobiera wartość określającą, czy DataGridColumn obiekt jest oznaczony w celu zapisania stanu. (Odziedziczone po DataGridColumn)
ItemStyle	Pobiera właściwości stylu dla komórek elementów kolumny. (Odziedziczone po DataGridColumn)
Owner	Pobiera kontrolkę DataGrid , do którego należy kolumna. (Odziedziczone po DataGridColumn)
SortExpression	Pobiera lub ustawia nazwę pola lub wyrażenia, które ma być przekazywane do OnSortCommand(DataGridSortCommandEventArgs) metody po wybraniu kolumny do sortowania. (Odziedziczone po DataGridColumn)
Text	Pobiera lub ustawia podpis wyświetlane w przyciskach ButtonColumn obiektu.
ValidationGroup	Pobiera lub ustawia grupę kontrolek weryfikacji, dla których ButtonColumn obiekt powoduje walidację, gdy publikuje z powrotem na serwerze.
ViewState	StateBag Pobiera obiekt, który umożliwia kolumnie pochodzącej DataGridColumn z klasy przechowywanie jego właściwości. (Odziedziczone po DataGridColumn)
Visible	Pobiera lub ustawia wartość wskazującą, czy kolumna jest widoczna w kontrolce DataGrid . (Odziedziczone po DataGridColumn)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
FormatDataTextValue(Object)	Konwertuje określoną wartość na format wskazywany przez DataTextFormatString właściwość.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
Initialize()	Resetuje obiekt do stanu początkowego ButtonColumn .
InitializeCell(TableCell, Int32, ListItemType)	Resetuje komórkę w obiekcie do stanu początkowego ButtonColumn .
LoadViewState(Object)	Ładuje stan DataGridColumn obiektu. (Odziedziczone po DataGridColumn)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnColumnChanged()	Wywołuje metodę OnColumnsChanged() . (Odziedziczone po DataGridColumn)
SaveViewState()	Zapisuje bieżący stan DataGridColumn obiektu. (Odziedziczone po DataGridColumn)
ToString()	Zwraca reprezentację ciągu kolumny. (Odziedziczone po DataGridColumn)
TrackViewState()	Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu mogą być przechowywane w obiekcie kontroli StateBag serwera. (Odziedziczone po DataGridColumn)

Jawne implementacje interfejsu

IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy kolumna śledzi zmiany stanu widoku. (Odziedziczone po DataGridColumn)
IStateManager.LoadViewState(Object)	Ładuje wcześniej zapisany stan. (Odziedziczone po DataGridColumn)
IStateManager.SaveViewState()	Zwraca obiekt zawierający zmiany stanu. (Odziedziczone po DataGridColumn)
IStateManager.TrackViewState()	Rozpoczyna śledzenie zmian stanu. (Odziedziczone po DataGridColumn)

Zobacz też

• DataGrid
• DataGridColumn
• BoundColumn
• EditCommandColumn
• HyperLinkColumn
• TemplateColumn
• Button
• LinkButton