ButtonColumn Klasa

Definicja

Typ kolumny dla DataGrid kontrolki zawierającej przycisk zdefiniowany przez użytkownika.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
Dziedziczenie
ButtonColumn

Przykłady

Poniższy przykład kodu ilustruje sposób używania ButtonColumn klasy w DataGrid kontrolce do tworzenia przycisków dodawania .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

Uwagi

Użyj ButtonColumn klasy w DataGrid kontrolce, aby utworzyć przycisk, który odpowiada każdemu wierszowi w DataGrid kontrolce.Use the ButtonColumn class in a DataGrid control to create a button that corresponds with each row in the DataGrid control. Określ podpis wyświetlany na przyciskach przez ustawienie Text właściwości.Specify the caption that is displayed in the buttons by setting the Text property. Jeśli ustawisz Text Właściwość, wszystkie przyciski w ButtonColumn obiekcie mają taki sam podpis.If you set the Text property, all buttons in the ButtonColumn object share the same caption. Alternatywnie można powiązać ButtonColumn przyciski z polem w źródle danych.Alternatively, you can bind the ButtonColumn buttons to a field in a data source. Pozwala to wyświetlić różne podpisy dla każdego przycisku.This allows you to display different captions for each button. Wartości w określonym polu są używane dla podpisu tekstu.The values in the specified field are used for the text caption. Ustaw DataTextField Właściwość w celu powiązania ButtonColumn do pola w źródle danych.Set the DataTextField property to bind the ButtonColumn to a field in a data source.

Można sformatować podpisy wyświetlane na przyciskach przez ustawienie DataTextField właściwości na ciąg formatowania.You can format the captions that are displayed in the buttons by setting the DataTextField property with a formatting string.

Kliknięcie przycisków w ButtonColumn ItemCommand zdarzeniu wywołuje zdarzenie.Clicking the buttons in the ButtonColumn raises the ItemCommand event. Można programowo sterować akcją wykonywaną po kliknięciu przycisku przez udostępnienie obsługi zdarzenia dla ItemCommand zdarzenia.You can programmatically control the action that is performed when the button is clicked by providing an event handler for the ItemCommand event.

Domyślnie Walidacja strony nie jest wykonywana po kliknięciu przycisku w elemencie ButtonColumn .By default, page validation is not performed when a button in the ButtonColumn is clicked. Walidacja strony określa, czy kontrolki wejściowe skojarzone z kontrolką walidacji na stronie wszystkie przekazują reguły walidacji, które są określone przez kontrolkę walidacji.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. Aby przeprowadzić walidację strony po kliknięciu przycisku, ustaw CausesValidation Właściwość na true .To perform page validation when a button is clicked, set the CausesValidation property to true.

Konstruktory

ButtonColumn()

Inicjuje nowe wystąpienie klasy ButtonColumn.Initializes a new instance of the ButtonColumn class.

Właściwości

ButtonType

Pobiera lub ustawia typ przycisku, który ma być wyświetlany w ButtonColumn obiekcie.Gets or sets the type of button to display in the ButtonColumn object.

CausesValidation

Pobiera lub ustawia wartość wskazującą, czy Walidacja jest wykonywana po kliknięciu przycisku w ButtonColumn obiekcie.Gets or sets a value indicating whether validation is performed when a button in the ButtonColumn object is clicked.

CommandName

Pobiera lub ustawia ciąg, który reprezentuje polecenie do wykonania, gdy ButtonColumn zostanie kliknięty przycisk w obiekcie.Gets or sets a string that represents the command to perform when a button in the ButtonColumn object is clicked.

DataTextField

Pobiera lub ustawia nazwę pola ze źródła danych, które ma zostać powiązane z ButtonColumn obiektem.Gets or sets the field name from a data source to bind to the ButtonColumn object.

DataTextFormatString

Pobiera lub ustawia ciąg określający format wyświetlania podpisu w każdym przycisku.Gets or sets the string that specifies the display format for the caption in each button.

DesignMode

Pobiera wartość wskazującą, czy kolumna jest w trybie projektowania.Gets a value that indicates whether the column is in design mode.

(Odziedziczone po DataGridColumn)
FooterStyle

Pobiera właściwości stylu sekcji stopki w kolumnie.Gets the style properties for the footer section of the column.

(Odziedziczone po DataGridColumn)
FooterText

Pobiera lub ustawia tekst wyświetlany w sekcji stopki w kolumnie.Gets or sets the text displayed in the footer section of the column.

(Odziedziczone po DataGridColumn)
HeaderImageUrl

Pobiera lub ustawia lokalizację obrazu, który ma być wyświetlany w sekcji nagłówka kolumny.Gets or sets the location of an image to display in the header section of the column.

(Odziedziczone po DataGridColumn)
HeaderStyle

Pobiera właściwości stylu sekcji nagłówka kolumny.Gets the style properties for the header section of the column.

(Odziedziczone po DataGridColumn)
HeaderText

Pobiera lub ustawia tekst wyświetlany w sekcji nagłówek kolumny.Gets or sets the text displayed in the header section of the column.

(Odziedziczone po DataGridColumn)
IsTrackingViewState

Pobiera wartość określającą, czy DataGridColumn obiekt jest oznaczony do zapisania jego stanu.Gets a value that determines whether the DataGridColumn object is marked to save its state.

(Odziedziczone po DataGridColumn)
ItemStyle

Pobiera właściwości stylu dla komórek elementów w kolumnie.Gets the style properties for the item cells of the column.

(Odziedziczone po DataGridColumn)
Owner

Pobiera DataGrid kontrolkę, której członkiem jest kolumna.Gets the DataGrid control that the column is a member of.

(Odziedziczone po DataGridColumn)
SortExpression

Pobiera lub ustawia nazwę pola lub wyrażenia, które ma zostać przekazane do OnSortCommand(DataGridSortCommandEventArgs) metody w przypadku wybrania kolumny do sortowania.Gets or sets the name of the field or expression to pass to the OnSortCommand(DataGridSortCommandEventArgs) method when a column is selected for sorting.

(Odziedziczone po DataGridColumn)
Text

Pobiera lub ustawia podpis wyświetlany na przyciskach ButtonColumn obiektu.Gets or sets the caption that is displayed in the buttons of the ButtonColumn object.

ValidationGroup

Pobiera lub ustawia grupę kontrolek walidacji, dla których ButtonColumn obiekt powoduje sprawdzenie poprawności po zaksięgowaniu z powrotem na serwerze.Gets or sets the group of validation controls for which the ButtonColumn object causes validation when it posts back to the server.

ViewState

Pobiera StateBag obiekt, który umożliwia kolumnie pochodnej z DataGridColumn klasy przechowywanie jej właściwości.Gets the StateBag object that allows a column derived from the DataGridColumn class to store its properties.

(Odziedziczone po DataGridColumn)
Visible

Pobiera lub ustawia wartość wskazującą, czy kolumna jest widoczna w DataGrid formancie.Gets or sets a value that indicates whether the column is visible in the DataGrid control.

(Odziedziczone po DataGridColumn)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
FormatDataTextValue(Object)

Konwertuje określoną wartość na format, który jest wskazywany przez DataTextFormatString Właściwość.Converts the specified value to the format that is indicated by the DataTextFormatString property.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
Initialize()

Resetuje ButtonColumn obiekt do stanu początkowego.Resets the ButtonColumn object to its initial state.

InitializeCell(TableCell, Int32, ListItemType)

Resetuje komórkę w ButtonColumn obiekcie do stanu początkowego.Resets a cell in the ButtonColumn object to its initial state.

LoadViewState(Object)

Ładuje stan DataGridColumn obiektu.Loads the state of the DataGridColumn object.

(Odziedziczone po DataGridColumn)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnColumnChanged()

Wywołuje OnColumnsChanged() metodę.Calls the OnColumnsChanged() method.

(Odziedziczone po DataGridColumn)
SaveViewState()

Zapisuje bieżący stan DataGridColumn obiektu.Saves the current state of the DataGridColumn object.

(Odziedziczone po DataGridColumn)
ToString()

Zwraca ciąg reprezentujący kolumnę.Returns the string representation of the column.

(Odziedziczone po DataGridColumn)
TrackViewState()

Powoduje śledzenie zmian stanu widoku w formancie serwera, aby mogły być przechowywane w obiekcie formantu serwera StateBag .Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object.

(Odziedziczone po DataGridColumn)

Jawne implementacje interfejsu

IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy kolumna śledzi zmiany stanu widoku.Gets a value that indicates whether the column is tracking view state changes.

(Odziedziczone po DataGridColumn)
IStateManager.LoadViewState(Object)

Ładuje wcześniej zapisany stan.Loads previously saved state.

(Odziedziczone po DataGridColumn)
IStateManager.SaveViewState()

Zwraca obiekt zawierający zmiany stanu.Returns an object containing state changes.

(Odziedziczone po DataGridColumn)
IStateManager.TrackViewState()

Uruchamia śledzenie zmian stanu.Starts tracking state changes.

(Odziedziczone po DataGridColumn)

Dotyczy

Zobacz też