ButtonColumn-Klasse

Artikel
08/20/2007

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

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Class ButtonColumn
    Inherits DataGridColumn
'Usage
Dim instance As ButtonColumn

public class ButtonColumn : DataGridColumn

public ref class ButtonColumn : public DataGridColumn

public class ButtonColumn extends DataGridColumn

public class ButtonColumn extends DataGridColumn

Hinweise

Mithilfe der ButtonColumn-Klasse wird in einem DataGrid-Steuerelement eine Schaltfläche erstellt, die jeder einzelnen Zeile im DataGrid-Steuerelement zugeordnet ist. Geben Sie durch Festlegen der Text-Eigenschaft die auf den Schaltflächen angezeigte Beschriftung an. Wenn Sie die Text-Eigenschaft festlegen, erhalten alle Schaltflächen im ButtonColumn-Objekt die gleiche Beschriftung. Sie können auch die ButtonColumn-Schaltflächen an ein Feld in einer Datenquelle binden. Dies ermöglicht Ihnen das Anzeigen unterschiedlicher Beschriftungen auf den einzelnen Schaltflächen. Die Werte im angegebenen Feld werden für die Textbeschriftung verwendet. Legen Sie die DataTextField-Eigenschaft fest, um die ButtonColumn an ein Feld in einer Datenquelle zu binden.

Sie können die auf den Schaltflächen angezeigten Beschriftungen formatieren, indem Sie die DataTextField-Eigenschaft auf eine Formatzeichenfolge festlegen.

Durch Klicken auf die Schaltflächen in der ButtonColumn wird das ItemCommand-Ereignis ausgelöst. Sie können die Aktion, die bei Klicken auf die Schaltfläche ausgeführt wird, programmgesteuert steuern, indem Sie einen Ereignishandler für das ItemCommand-Ereignis bereitstellen.

Es wird standardmäßig keine Seitenvalidierung ausgeführt, wenn auf eine Schaltfläche in der ButtonColumn geklickt wird. Die Seitenvalidierung bestimmt, ob die einem Validierungssteuerelement auf der Seite zugeordneten Eingabesteuerelemente allen Validierungsregeln entsprechen, die durch das Validierungssteuerelement festgelegt sind. Damit durch das Klicken auf eine Schaltfläche eine Seitenvalidierung ausgeführt wird, legen Sie die CausesValidation-Eigenschaft auf true fest.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie mit der ButtonColumn-Klasse in einem DataGrid-Steuerelement Hinzufügen-Schaltflächen erstellt werden.

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 'Page_Init

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 void Page_Init(Object sender, EventArgs e)
{
    // Create dynamic column to add to Columns collection.
    ButtonColumn addColumn = new ButtonColumn();
    addColumn.set_HeaderText("Add Item");
    addColumn.set_Text("Add");
    addColumn.set_CommandName("Add");
    addColumn.set_ButtonType(ButtonColumnType.PushButton);
 

    // Add column to Columns collection.
    itemsGrid.get_Columns().AddAt(2, addColumn);
} //Page_Init

private function Page_Init(sender : Object, e : EventArgs) 
{

   // Create dynamic column to add to Columns collection.
   var AddColumn : ButtonColumn = 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);

}

Vererbungshierarchie

System.Object
System.Web.UI.WebControls.DataGridColumn
System.Web.UI.WebControls.ButtonColumn

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ButtonColumn-Member
System.Web.UI.WebControls-Namespace
DataGrid
DataGridColumn
BoundColumn-Klasse
EditCommandColumn
HyperLinkColumn
TemplateColumn
Button-Klasse
LinkButton

Freigeben über