Freigeben über

ButtonColumn Klasse

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

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 die Verwendung der ButtonColumn Klasse in einem DataGrid Steuerelement zum Erstellen von Add-Schaltflächen veranschaulicht.

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 Beschriftung 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 Beschriftung. Alternativ können Sie die ButtonColumn Schaltflächen an ein Feld in einer Datenquelle binden. Auf diese Weise können Sie für jede Schaltfläche unterschiedliche Beschriftungen anzeigen. Die Werte im angegebenen Feld werden für die Textbeschriftung verwendet. Legen Sie die DataTextField Eigenschaft fest, um das ButtonColumn Feld in einer Datenquelle an ein Feld 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 Ereignis wird das ItemCommand Ereignis ausgelöst. Sie können die Aktion programmgesteuert steuern, die ausgeführt wird, wenn auf die Schaltfläche geklickt wird, indem Sie einen Ereignishandler für das ItemCommand Ereignis angeben.

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

Konstruktoren

Name Beschreibung
ButtonColumn()

Initialisiert eine neue Instanz der ButtonColumn-Klasse.

Eigenschaften

Name Beschreibung
ButtonType

Dient zum Abrufen oder Festlegen des Typs der Schaltfläche, die ButtonColumn im Objekt angezeigt werden soll.
CausesValidation

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Überprüfung ausgeführt wird, wenn auf eine Schaltfläche im ButtonColumn Objekt geklickt wird.
CommandName

Dient zum Abrufen oder Festlegen einer Zeichenfolge, die den Auszuführenden Befehl darstellt, wenn auf eine Schaltfläche im ButtonColumn Objekt geklickt wird.
DataTextField

Dient zum Abrufen oder Festlegen des Feldnamens aus einer Datenquelle, die an das ButtonColumn Objekt gebunden werden soll.
DataTextFormatString

Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Anzeigeformat für die Beschriftung in jeder Schaltfläche angibt.
DesignMode

Ruft einen Wert ab, der angibt, ob sich die Spalte im Entwurfsmodus befindet.

(Geerbt von DataGridColumn)
FooterStyle

Ruft die Formatvorlageneigenschaften für den Fußzeilenabschnitt der Spalte ab.

(Geerbt von DataGridColumn)
FooterText

Dient zum Abrufen oder Festlegen des Texts, der im Fußzeilenabschnitt der Spalte angezeigt wird.

(Geerbt von DataGridColumn)
HeaderImageUrl

Dient zum Abrufen oder Festlegen der Position eines Bilds, das im Kopfzeilenabschnitt der Spalte angezeigt werden soll.

(Geerbt von DataGridColumn)
HeaderStyle

Ruft die Formatvorlageneigenschaften für den Kopfzeilenabschnitt der Spalte ab.

(Geerbt von DataGridColumn)
HeaderText

Dient zum Abrufen oder Festlegen des Texts, der im Kopfzeilenabschnitt der Spalte angezeigt wird.

(Geerbt von DataGridColumn)
IsTrackingViewState

Ruft einen Wert ab, der bestimmt, ob das DataGridColumn Objekt zum Speichern des Zustands markiert ist.

(Geerbt von DataGridColumn)
ItemStyle

Ruft die Formatvorlageneigenschaften für die Elementzellen der Spalte ab.

(Geerbt von DataGridColumn)
Owner

Ruft das DataGrid Steuerelement ab, bei dem es sich bei der Spalte um ein Element handelt.

(Geerbt von DataGridColumn)
SortExpression

Dient zum Abrufen oder Festlegen des Namens des Felds oder Ausdrucks, das an die Methode übergeben werden soll, wenn eine Spalte für die OnSortCommand(DataGridSortCommandEventArgs) Sortierung ausgewählt ist.

(Geerbt von DataGridColumn)
Text

Dient zum Abrufen oder Festlegen der Beschriftung, die in den Schaltflächen des ButtonColumn Objekts angezeigt wird.
ValidationGroup

Dient zum Abrufen oder Festlegen der Gruppe von Überprüfungssteuerelementen, für die das ButtonColumn Objekt eine Überprüfung verursacht, wenn es wieder auf dem Server veröffentlicht wird.
ViewState

Ruft das StateBag Objekt ab, das eine von der DataGridColumn Klasse abgeleitete Spalte zum Speichern seiner Eigenschaften zulässt.

(Geerbt von DataGridColumn)
Visible

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Spalte im DataGrid Steuerelement sichtbar ist.

(Geerbt von DataGridColumn)

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
FormatDataTextValue(Object)

Konvertiert den angegebenen Wert in das Format, das durch die DataTextFormatString Eigenschaft angegeben wird.
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
Initialize()

Setzt das ButtonColumn Objekt auf den Anfangszustand zurück.
InitializeCell(TableCell, Int32, ListItemType)

Setzt eine Zelle im ButtonColumn Objekt auf den Anfangszustand zurück.
LoadViewState(Object)

Lädt den Zustand des DataGridColumn Objekts.

(Geerbt von DataGridColumn)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
OnColumnChanged()

Ruft die OnColumnsChanged() Methode auf.

(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()

Bewirkt die Nachverfolgung von Ansichtszustandsänderungen am Serversteuerelement, sodass sie im Objekt des Serversteuerelements StateBag gespeichert werden können.

(Geerbt von DataGridColumn)

Explizite Schnittstellenimplementierungen

Name Beschreibung
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob die Spalte Ansichtszustandsänderungen nachverfolgt.

(Geerbt von DataGridColumn)
IStateManager.LoadViewState(Object)

Lädt den zuvor gespeicherten Zustand.

(Geerbt von DataGridColumn)
IStateManager.SaveViewState()

Gibt ein Objekt zurück, das Zustandsänderungen enthält.

(Geerbt von DataGridColumn)
IStateManager.TrackViewState()

Beginnt mit der Nachverfolgung von Zustandsänderungen.

(Geerbt von DataGridColumn)

Gilt für:

Weitere Informationen