ButtonColumn ButtonColumn ButtonColumn ButtonColumn Class

Definition

Ein Spaltentyp für das DataGrid-Steuerelement, das eine benutzerdefinierte Schaltfläche enthält.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
Vererbung

Beispiele

Im folgenden Codebeispiel wird die Verwendung ButtonColumn der-Klasse in einem DataGrid -Steuerelement zum Erstellen von Schaltflächen zum Hinzufügen veranschaulichtThe 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

Hinweise

Verwenden Sie ButtonColumn die-Klasse DataGrid in einem-Steuerelement, um eine Schaltfläche zu erstellen DataGrid , die jeder Zeile im-Steuerelement entspricht.Use the ButtonColumn class in a DataGrid control to create a button that corresponds with each row in the DataGrid control. Geben Sie die Beschriftung an, die in den Schaltflächen angezeigt Text wird, indem Sie die Eigenschaft festlegen.Specify the caption that is displayed in the buttons by setting the Text property. Wenn Sie die Text -Eigenschaft festlegen, haben alle Schalt ButtonColumn Flächen im-Objekt dieselbe Beschriftung.If you set the Text property, all buttons in the ButtonColumn object share the same caption. Alternativ können Sie die ButtonColumn Schaltflächen an ein Feld in einer Datenquelle binden.Alternatively, you can bind the ButtonColumn buttons to a field in a data source. Dies ermöglicht es Ihnen, für jede Schaltfläche verschiedene Beschriftungen anzuzeigen.This allows you to display different captions for each button. Die Werte im angegebenen Feld werden für den Beschriftungs Text verwendet.The values in the specified field are used for the text caption. Legen Sie DataTextField die-Eigenschaft fest ButtonColumn , um die an ein Feld in einer Datenquelle zu binden.Set the DataTextField property to bind the ButtonColumn to a field in a data source.

Sie können die Beschriftungen, die in den Schaltflächen angezeigt werden, formatieren, indem Sie die DataTextField Eigenschaft mit einer Formatierungs Zeichenfolge festlegenYou can format the captions that are displayed in the buttons by setting the DataTextField property with a formatting string.

Durch Klicken auf die Schalt ButtonColumn Flächen in ItemCommand der wird das-Ereignis ausgelöst.Clicking the buttons in the ButtonColumn raises the ItemCommand event. Sie können die Aktion, die ausgeführt wird, wenn auf die Schaltfläche geklickt wird, Programm gesteuert steuern, indem ItemCommand Sie einen Ereignishandler für das-Ereignis bereitstellen.You can programmatically control the action that is performed when the button is clicked by providing an event handler for the ItemCommand event.

Standardmäßig wird die Seiten Validierung nicht ausgeführt, wenn auf eine Schalt ButtonColumn Fläche in der geklickt wird.By default, page validation is not performed when a button in the ButtonColumn is clicked. Die Seiten Validierung bestimmt, ob die Eingabe Steuerelemente, die mit einem Validierungs Steuerelement auf der Seite verknüpft sind, die Validierungsregeln bestehen, die vom Validierungs Steuerelement angegeben werden.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. Wenn Sie beim Klicken auf eine Schaltfläche eine Seiten Validierung ausführen CausesValidation möchten, truelegen Sie die-Eigenschaft auf fest.To perform page validation when a button is clicked, set the CausesValidation property to true.

Konstruktoren

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

Initialisiert eine neue Instanz der ButtonColumn-Klasse.Initializes a new instance of the ButtonColumn class.

Eigenschaften

ButtonType ButtonType ButtonType ButtonType

Ruft den Typ der im ButtonColumn-Objekt anzuzeigenden Schaltfläche ab oder legt diesen fest.Gets or sets the type of button to display in the ButtonColumn object.

CausesValidation CausesValidation CausesValidation CausesValidation

Ruft einen Wert ab, der angibt, ob beim Klicken auf eine Schaltfläche im ButtonColumn-Objekt eine Validierung durchgeführt wird, oder legt diesen fest.Gets or sets a value indicating whether validation is performed when a button in the ButtonColumn object is clicked.

CommandName CommandName CommandName CommandName

Ruft eine Zeichenfolge ab, die den Befehl darstellt, der beim Klicken auf eine Schaltfläche im ButtonColumn-Objekt ausgeführt werden soll, oder legt diese Zeichenfolge fest.Gets or sets a string that represents the command to perform when a button in the ButtonColumn object is clicked.

DataTextField DataTextField DataTextField DataTextField

Ruft den Namen des Felds aus einer Datenquelle ab, das an das ButtonColumn-Objekt gebunden werden soll, oder legt diesen fest.Gets or sets the field name from a data source to bind to the ButtonColumn object.

DataTextFormatString DataTextFormatString DataTextFormatString DataTextFormatString

Ruft die Zeichenfolge ab, die das Anzeigeformat der Beschriftung für jede Schaltfläche angibt, oder legt diese fest.Gets or sets the string that specifies the display format for the caption in each button.

DesignMode DesignMode DesignMode DesignMode

Ruft einen Wert ab, der angibt, ob sich die Spalte im Entwurfsmodus befindet.Gets a value that indicates whether the column is in design mode.

(Inherited from DataGridColumn)
FooterStyle FooterStyle FooterStyle FooterStyle

Ruft die Formatierungseigenschaften für den Fußzeilenbereich der Spalte ab.Gets the style properties for the footer section of the column.

(Inherited from DataGridColumn)
FooterText FooterText FooterText FooterText

Ruft den im Fußzeilenbereich der Spalte angezeigten Text ab oder legt diesen fest.Gets or sets the text displayed in the footer section of the column.

(Inherited from DataGridColumn)
HeaderImageUrl HeaderImageUrl HeaderImageUrl HeaderImageUrl

Ruft den Speicherort eines Bilds ab, das im Headerbereich der Spalte angezeigt werden soll, oder legt diesen fest.Gets or sets the location of an image to display in the header section of the column.

(Inherited from DataGridColumn)
HeaderStyle HeaderStyle HeaderStyle HeaderStyle

Ruft die Formatierungseigenschaften für den Headerbereich der Spalte ab.Gets the style properties for the header section of the column.

(Inherited from DataGridColumn)
HeaderText HeaderText HeaderText HeaderText

Ruft den im Headerbereich der Spalte angezeigten Text ab oder legt diesen fest.Gets or sets the text displayed in the header section of the column.

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

Ruft einen Wert ab, der angibt, ob die Spalte Änderungen des Ansichtszustands nachverfolgt.Gets a value that indicates whether the column is tracking view state changes.

(Inherited from DataGridColumn)
IsTrackingViewState IsTrackingViewState IsTrackingViewState IsTrackingViewState

Ruft einen Wert ab, der bestimmt, ob das DataGridColumn-Objekt markiert wird, um seinen Zustand zu speichern.Gets a value that determines whether the DataGridColumn object is marked to save its state.

(Inherited from DataGridColumn)
ItemStyle ItemStyle ItemStyle ItemStyle

Ruft die Formatierungseigenschaften für die einzelnen Zellen der Spalte ab.Gets the style properties for the item cells of the column.

(Inherited from DataGridColumn)
Owner Owner Owner Owner

Ruft das DataGrid-Steuerelement ab, zu dessen Membern die Spalte gehört.Gets the DataGrid control that the column is a member of.

(Inherited from DataGridColumn)
SortExpression SortExpression SortExpression SortExpression

Ruft den Namen des Felds oder Ausdrucks ab, der an die OnSortCommand(DataGridSortCommandEventArgs)-Methode übergeben wird, wenn eine Spalte für die Sortierung ausgewählt wurde, oder legt diesen fest.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

Ruft die Beschriftung ab, die auf den Schaltflächen des ButtonColumn-Objekts angezeigt wird, oder legt diese fest.Gets or sets the caption that is displayed in the buttons of the ButtonColumn object.

ValidationGroup ValidationGroup ValidationGroup ValidationGroup

Ruft die Gruppe von Validierungssteuerelementen ab, für die das ButtonColumn-Objekt eine Validierung bewirkt, wenn ein Postback an den Server ausgeführt wird, oder legt diese Gruppe fest.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

Ruft das StateBag-Objekt ab, wodurch einer von der DataGridColumn-Klasse abgeleiteten Spalte ermöglicht wird, ihre Eigenschaften zu speichern.Gets the StateBag object that allows a column derived from the DataGridColumn class to store its properties.

(Inherited from DataGridColumn)
Visible Visible Visible Visible

Ruft einen Wert ab, der angibt, ob die Spalte im DataGrid-Steuerelement sichtbar ist, oder legt diesen fest.Gets or sets a value that indicates whether the column is visible in the DataGrid control.

(Inherited from DataGridColumn)

Methoden

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Konvertiert den angegebenen Wert in das von der DataTextFormatString-Eigenschaft angegebene Format.Converts the specified value to the format that is indicated by the DataTextFormatString property.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Setzt das ButtonColumn-Objekt auf den Ausgangszustand zurück.Resets the ButtonColumn object to its initial state.

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

Setzt eine Zelle im ButtonColumn-Objekt auf den Ausgangszustand zurück.Resets a cell in the ButtonColumn object to its initial state.

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

Lädt den Zustand des DataGridColumn-Objekts.Loads the state of the DataGridColumn object.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Aufruf der OnColumnsChanged()-Methode.Calls the OnColumnsChanged() method.

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

Speichert den aktuellen Zustand des DataGridColumn-Objekts.Saves the current state of the DataGridColumn object.

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

Gibt die Zeichenfolgendarstellung der Spalte zurück.Returns the string representation of the column.

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

Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können.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)

Explizite Schnittstellenimplementierungen

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

Lädt den früher gespeicherten Zustand.Loads previously saved state.

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

Gibt ein Objekt zurück, das Zustandsänderungen enthält.Returns an object containing state changes.

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

Startet das Verfolgen von Zustandsänderungen.Starts tracking state changes.

(Inherited from DataGridColumn)

Gilt für:

Siehe auch