ButtonColumn Klasa

Definicja

Namespace:: System.Web.UI.WebControls

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

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.

Konstruktorów

Nazwa	Opis
ButtonColumn()	Inicjuje nowe wystąpienie klasy ButtonColumn.

Właściwości

Nazwa	Opis
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. (Dziedziczone od DataGridColumn)
FooterStyle	Pobiera właściwości stylu dla sekcji stopki kolumny. (Dziedziczone od DataGridColumn)
FooterText	Pobiera lub ustawia tekst wyświetlany w sekcji stopki kolumny. (Dziedziczone od DataGridColumn)
HeaderImageUrl	Pobiera lub ustawia lokalizację obrazu do wyświetlenia w sekcji nagłówka kolumny. (Dziedziczone od DataGridColumn)
HeaderStyle	Pobiera właściwości stylu dla sekcji nagłówka kolumny. (Dziedziczone od DataGridColumn)
HeaderText	Pobiera lub ustawia tekst wyświetlany w sekcji nagłówka kolumny. (Dziedziczone od DataGridColumn)
IsTrackingViewState	Pobiera wartość określającą, czy DataGridColumn obiekt jest oznaczony w celu zapisania stanu. (Dziedziczone od DataGridColumn)
ItemStyle	Pobiera właściwości stylu dla komórek elementów kolumny. (Dziedziczone od DataGridColumn)
Owner	Pobiera kontrolkę DataGrid , do którego należy kolumna. (Dziedziczone od DataGridColumn)
SortExpression	Pobiera lub ustawia nazwę pola lub wyrażenia, które ma być przekazywane do OnSortCommand(DataGridSortCommandEventArgs) metody po wybraniu kolumny do sortowania. (Dziedziczone od 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. (Dziedziczone od DataGridColumn)
Visible	Pobiera lub ustawia wartość wskazującą, czy kolumna jest widoczna w kontrolce DataGrid . (Dziedziczone od DataGridColumn)

Metody

Nazwa	Opis
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Dziedziczone od 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. (Dziedziczone od Object)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od 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. (Dziedziczone od DataGridColumn)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
OnColumnChanged()	Wywołuje metodę OnColumnsChanged() . (Dziedziczone od DataGridColumn)
SaveViewState()	Zapisuje bieżący stan DataGridColumn obiektu. (Dziedziczone od DataGridColumn)
ToString()	Zwraca reprezentację ciągu kolumny. (Dziedziczone od DataGridColumn)
TrackViewState()	Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu mogą być przechowywane w obiekcie kontroli StateBag serwera. (Dziedziczone od DataGridColumn)

Implementacje interfejsów jawnych

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

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?