ButtonColumn Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ein Spaltentyp für das DataGrid-Steuerelement, das eine benutzerdefinierte Schaltfläche enthält.

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: Object

DataGridColumn
ButtonColumn

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Klasse in einem DataGrid Steuerelement verwendenButtonColumn, um Schaltflächen hinzufügen zu erstellen.

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 die ButtonColumn -Klasse in einem DataGrid -Steuerelement, um eine Schaltfläche zu erstellen, die jeder Zeile im DataGrid Steuerelement entspricht. Geben Sie die Untertitel an, die in den Schaltflächen angezeigt wird, indem Sie die Text -Eigenschaft festlegen. Wenn Sie die Text -Eigenschaft festlegen, verwenden alle Schaltflächen im ButtonColumn Objekt dieselbe Untertitel. Alternativ können Sie die ButtonColumn Schaltflächen an ein Feld in einer Datenquelle binden. Dadurch können Sie verschiedene Beschriftungen für jede Schaltfläche anzeigen. Die Werte im angegebenen Feld werden für den Text verwendet, der Untertitel. Legen Sie die DataTextField -Eigenschaft fest, um die ButtonColumn an ein Feld in einer Datenquelle zu binden.

Sie können die Beschriftungen formatieren, die in den Schaltflächen angezeigt werden, indem Sie die DataTextField Eigenschaft mit einer Formatierungszeichenfolge festlegen.

Durch Klicken auf die Schaltflächen im ButtonColumn löst das Ereignis aus ItemCommand . Sie können die Aktion, die beim Klicken auf die Schaltfläche ausgeführt wird, programmgesteuert steuern, indem Sie einen Ereignishandler für das ItemCommand Ereignis bereitstellen.

Standardmäßig wird die Seitenüberprüfung nicht ausgeführt, wenn auf eine Schaltfläche in der ButtonColumn geklickt wird. Die Seitenüberprüfung bestimmt, ob die Eingabesteuerelemente, die einem Validierungssteuerelement auf der Seite zugeordnet sind, die Validierungsregeln, die vom Validierungssteuerelement angegeben werden, alle bestehen. Um die Seitenüberprüfung durchzuführen, wenn auf eine Schaltfläche geklickt wird, legen Sie die CausesValidation -Eigenschaft auf truefest.

Konstruktoren

ButtonColumn()

Initialisiert eine neue Instanz der ButtonColumn-Klasse.

Eigenschaften

ButtonType	Ruft den Typ der im ButtonColumn-Objekt anzuzeigenden Schaltfläche ab oder legt diesen fest.
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.
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.
DataTextField	Ruft den Namen des Felds aus einer Datenquelle ab, das an das ButtonColumn-Objekt gebunden werden soll, oder legt diesen fest.
DataTextFormatString	Ruft die Zeichenfolge ab, die das Anzeigeformat der Beschriftung für jede Schaltfläche angibt, oder legt diese fest.
DesignMode	Ruft einen Wert ab, der angibt, ob sich die Spalte im Entwurfsmodus befindet. (Geerbt von DataGridColumn)
FooterStyle	Ruft die Formatierungseigenschaften für den Fußzeilenbereich der Spalte ab. (Geerbt von DataGridColumn)
FooterText	Ruft den im Fußzeilenbereich der Spalte angezeigten Text ab oder legt diesen fest. (Geerbt von DataGridColumn)
HeaderImageUrl	Ruft den Speicherort eines Bilds ab, das im Headerbereich der Spalte angezeigt werden soll, oder legt diesen fest. (Geerbt von DataGridColumn)
HeaderStyle	Ruft die Formatierungseigenschaften für den Headerbereich der Spalte ab. (Geerbt von DataGridColumn)
HeaderText	Ruft den im Headerbereich der Spalte angezeigten Text ab oder legt diesen fest. (Geerbt von DataGridColumn)
IsTrackingViewState	Ruft einen Wert ab, der bestimmt, ob das DataGridColumn-Objekt markiert wird, um seinen Zustand zu speichern. (Geerbt von DataGridColumn)
ItemStyle	Ruft die Formatierungseigenschaften für die einzelnen Zellen der Spalte ab. (Geerbt von DataGridColumn)
Owner	Ruft das DataGrid-Steuerelement ab, zu dessen Membern die Spalte gehört. (Geerbt von DataGridColumn)
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. (Geerbt von DataGridColumn)
Text	Ruft die Beschriftung ab, die auf den Schaltflächen des ButtonColumn-Objekts angezeigt wird, oder legt diese fest.
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.
ViewState	Ruft das StateBag-Objekt ab, wodurch einer von der DataGridColumn-Klasse abgeleiteten Spalte ermöglicht wird, ihre Eigenschaften zu speichern. (Geerbt von DataGridColumn)
Visible	Ruft einen Wert ab, der angibt, ob die Spalte im DataGrid-Steuerelement sichtbar ist, oder legt diesen fest. (Geerbt von DataGridColumn)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
FormatDataTextValue(Object)	Konvertiert den angegebenen Wert in das von der DataTextFormatString-Eigenschaft angegebene Format.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Initialize()	Setzt das ButtonColumn-Objekt auf den Ausgangszustand zurück.
InitializeCell(TableCell, Int32, ListItemType)	Setzt eine Zelle im ButtonColumn-Objekt auf den Ausgangszustand zurück.
LoadViewState(Object)	Lädt den Zustand des DataGridColumn-Objekts. (Geerbt von DataGridColumn)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnColumnChanged()	Aufruf der OnColumnsChanged()-Methode. (Geerbt von DataGridColumn)
SaveViewState()	Speichert den aktuellen Zustand des DataGridColumn-Objekts. (Geerbt von DataGridColumn)
ToString()	Gibt die Zeichenfolgendarstellung der Spalte zurück. (Geerbt von DataGridColumn)
TrackViewState()	Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können. (Geerbt von DataGridColumn)

Explizite Schnittstellenimplementierungen

IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob die Spalte Änderungen des Ansichtszustands nachverfolgt. (Geerbt von DataGridColumn)
IStateManager.LoadViewState(Object)	Lädt den früher gespeicherten Zustand. (Geerbt von DataGridColumn)
IStateManager.SaveViewState()	Gibt ein Objekt zurück, das Zustandsänderungen enthält. (Geerbt von DataGridColumn)
IStateManager.TrackViewState()	Startet das Verfolgen von Zustandsänderungen. (Geerbt von DataGridColumn)

Gilt für: