Freigeben über


ButtonField Klasse

Definition

Stellt ein Feld dar, das als Schaltfläche in einem datengebundenen Steuerelement angezeigt wird.

public ref class ButtonField : System::Web::UI::WebControls::ButtonFieldBase
public class ButtonField : System.Web.UI.WebControls.ButtonFieldBase
type ButtonField = class
    inherit ButtonFieldBase
Public Class ButtonField
Inherits ButtonFieldBase
Vererbung

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ButtonField -Objekt verwendet wird, um eine Spalte von Befehlsschaltflächen in einem GridView Steuerelement anzuzeigen.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

  void CustomersGridView_RowCommand(Object sender, GridViewCommandEventArgs e)
  {
  
    // If multiple ButtonField column fields are used, use the
    // CommandName property to determine which button was clicked.
    if(e.CommandName=="Select")
    {
    
      // Convert the row index stored in the CommandArgument
      // property to an Integer.
      int index = Convert.ToInt32(e.CommandArgument);    
    
      // Get the last name of the selected author from the appropriate
      // cell in the GridView control.
      GridViewRow selectedRow = CustomersGridView.Rows[index];
      TableCell contactName = selectedRow.Cells[1];
      string contact = contactName.Text;  
    
      // Display the selected author.
      Message.Text = "You selected " + contact + ".";
      
    }
    
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>

<%@ Page language="VB" %>


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    Sub CustomersGridView_RowCommand(ByVal sender As Object, ByVal e As GridViewCommandEventArgs)
  
        ' If multiple ButtonField column fields are used, use the
        ' CommandName property to determine which button was clicked.
        If e.CommandName = "Select" Then
    
            ' Convert the row index stored in the CommandArgument
            ' property to an Integer.
            Dim index As Integer = Convert.ToInt32(e.CommandArgument)
    
            ' Get the last name of the selected author from the appropriate
            ' cell in the GridView control.
            Dim selectedRow As GridViewRow = CustomersGridView.Rows(index)
            Dim contactCell As TableCell = selectedRow.Cells(1)
            Dim contact As String = contactCell.Text
    
            ' Display the selected author.
            Message.Text = "You selected " & contact & "."
      
        End If
    
    End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ButtonField Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>ButtonField Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Populate the Columns collection declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Button" 
            commandname="Select"
            headertext="Select Customer" 
            text="Select"/>
          <asp:boundfield datafield="CompanyName" 
            headertext="Company Name"/>
          <asp:boundfield datafield="ContactName" 
            headertext="Contact Name"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [CompanyName], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>

Hinweise

Die ButtonField -Klasse wird von datengebundenen Steuerelementen (z GridView . B. und DetailsView) verwendet, um eine Schaltfläche für jeden angezeigten Datensatz anzuzeigen. Das ButtonField Objekt wird je nach dem datengebundenen Steuerelement, in dem es verwendet wird, unterschiedlich angezeigt. Beispielsweise zeigt das GridView Steuerelement ein ButtonField Objekt als Spalte an, während es vom DetailsView Steuerelement als Zeile angezeigt wird.

Wenn Sie in einem Schaltflächenfeld auf eine Schaltfläche klicken, wird das Befehlsereignis des übergeordneten datengebundenen Steuerelements ausgelöst. Sie können eine benutzerdefinierte Routine bereitstellen, die ausgeführt wird, wenn auf eine Befehlsschaltfläche geklickt wird, indem Sie einen Ereignishandler für das Befehlsereignis bereitstellen.

Hinweis

Das GridView -Steuerelement löst das RowCommand -Ereignis aus, während das DetailsView -Steuerelement das ItemCommand -Ereignis auslöst.

Um den Index des Datensatzes zu bestimmen, der das Befehlsereignis auslöst, verwenden Sie die CommandArgument -Eigenschaft des Ereignisarguments, das an das Befehlsereignis für das datengebundene Steuerelement übergeben wird. Die ButtonField -Klasse füllt die CommandArgument -Eigenschaft automatisch mit dem entsprechenden Indexwert auf.

Verwenden Sie die -Eigenschaft, um den ButtonType Typ der anzuzeigenden Schaltfläche anzugeben. Verwenden Sie beim Anzeigen einer Link- oder Befehlsschaltfläche die Text -Eigenschaft, um die Untertitel anzugeben, die in den Schaltflächen angezeigt werden soll.

Hinweis

Wenn Sie die Text -Eigenschaft festlegen, verwenden alle Schaltflächen in einem ButtonField dieselbe Untertitel.

Alternativ können Sie das ButtonField Objekt an ein Feld in einer Datenquelle binden. Dadurch können Sie verschiedene Beschriftungen für die Schaltflächen im ButtonField -Objekt anzeigen. Die Werte im angegebenen Feld werden für die Textbeschriftungen der Schaltflächen verwendet. Legen Sie die DataTextField -Eigenschaft fest, um ein ButtonField Objekt an ein Feld in einer Datenquelle zu binden.

Verwenden Sie beim Anzeigen einer Bildschaltfläche die ImageUrl -Eigenschaft, um das Bild anzugeben, das für die Schaltflächen im ButtonField -Objekt angezeigt werden soll.

Hinweis

Alle Schaltflächen in einem ButtonField -Objekt teilen sich das gleiche Bild.

Sie können ein ButtonField Objekt in einem datengebundenen Steuerelement ausblenden, indem Sie die Visible -Eigenschaft auf falsefestlegen.

Mit ButtonField dem -Objekt können Sie die Kopf- und Fußzeilenabschnitte anpassen. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitt anzuzeigen, legen die HeaderText oder FooterText Eigenschaften bzw. Anstatt Text im Kopfzeilenabschnitt anzuzeigen, können Sie ein Bild anzeigen, indem Sie die HeaderImageUrl -Eigenschaft festlegen. Um den Headerabschnitt in einem ButtonField -Objekt auszublenden, legen Sie die ShowHeader -Eigenschaft auf fest false.

Hinweis

Einige datengebundene Steuerelemente (z. B. das GridView -Steuerelement) können nur den gesamten Headerabschnitt des Steuerelements anzeigen oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader -Eigenschaft für ein einzelnes Schaltflächenfeld nicht. Verwenden Sie ShowHeader die -Eigenschaft für das Steuerelement, um den gesamten Headerabschnitt eines datengebundenen Steuerelements (sofern verfügbar) ein- oder auszublenden.

Sie können auch die Darstellung des ButtonField Objekts (Schriftfarbe, Hintergrundfarbe usw.) anpassen, indem Sie die Stileigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Stileigenschaften aufgeführt.

Style-Eigenschaft Die Stileinstellungen für
ControlStyle Die untergeordneten Webserversteuerelemente von ButtonField.
FooterStyle Der Fußzeilenabschnitt von ButtonField.
HeaderStyle Der Headerabschnitt von ButtonField.
ItemStyle Die Datenelemente im ButtonField.

Konstruktoren

ButtonField()

Initialisiert eine neue Instanz der ButtonField-Klasse.

Eigenschaften

AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.

(Geerbt von DataControlField)
ButtonType

Ruft den Schaltflächentyp ab, der im Schaltflächenfeld angezeigt werden soll, oder legt diesen fest.

(Geerbt von ButtonFieldBase)
CausesValidation

Ruft einen Wert ab, der angibt, ob beim Klicken auf eine Schaltfläche in einem ButtonFieldBase-Objekt eine Validierung durchgeführt wird, oder legt diesen fest.

(Geerbt von ButtonFieldBase)
CommandName

Ruft eine Zeichenfolge ab, die die Aktion darstellt, die beim Klicken auf eine Schaltfläche in einem ButtonField-Objekt ausgeführt werden soll, oder legt diese fest.

Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.

(Geerbt von DataControlField)
ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.

(Geerbt von DataControlField)
DataTextField

Ruft den Namen des Datenfelds ab, für das der Wert an die Text-Eigenschaft des Button-Steuerelements gebunden ist, das durch das ButtonField-Objekt gerendert wird, oder legt diesen Namen fest.

DataTextFormatString

Ruft die Zeichenfolge ab, die das Anzeigeformat für den Wert des Felds angibt, oder legt diese fest.

DesignMode

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.

(Geerbt von DataControlField)
FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.

(Geerbt von DataControlField)
FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.

(Geerbt von DataControlField)
HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.

(Geerbt von DataControlField)
HeaderStyle

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.

(Geerbt von DataControlField)
HeaderText

Ruft den Text ab, der im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.

(Geerbt von DataControlField)
ImageUrl

Ruft das Bild ab, das für jede Schaltfläche im ButtonField-Objekt angezeigt werden soll, oder legt dieses fest.

InsertVisible

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet.

(Geerbt von DataControlField)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.

(Geerbt von DataControlField)
ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.

(Geerbt von DataControlField)
ShowHeader

Ruft einen Wert ab, der angibt, ob der Headerbereich in einem ButtonFieldBase-Objekt angezeigt wird, oder legt diesen Wert fest.

(Geerbt von ButtonFieldBase)
SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.

(Geerbt von DataControlField)
Text

Ruft die statische Beschriftung ab, die für jede Schaltfläche im ButtonField-Objekt angezeigt wird, oder legt diese fest.

ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.

(Geerbt von DataControlField)
ValidationGroup

Ruft den Namen der Gruppe von Validierungssteuerelementen ab, die beim Klicken auf eine Schaltfläche in einem ButtonFieldBase-Objekt validiert werden sollen, oder legt diesen fest.

(Geerbt von ButtonFieldBase)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField-Objekts über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.

(Geerbt von DataControlField)
Visible

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.

(Geerbt von DataControlField)

Methoden

CloneField()

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.

(Geerbt von DataControlField)
CopyProperties(DataControlField)

Kopiert die Eigenschaften des aktuellen ButtonField-Objekts in das angegebene DataControlField-Objekt.

CreateField()

Erstellt und gibt eine neue Instanz der ButtonField-Klasse zurück.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)

Extrahiert den Wert des Datensteuerelement-Felds aus der aktuellen Tabellenzelle und fügt den Wert der angegebenen IDictionary-Auflistung hinzu.

(Geerbt von DataControlField)
FormatDataTextValue(Object)

Formatiert den angegebenen Feldwert für eine Zelle im ButtonField-Objekt.

GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
Initialize(Boolean, Control)

Initialisiert das aktuelle ButtonField-Objekt.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialisiert das angegebene DataControlFieldCell-Objekt mit dem angegebenen Zeilenzustand.

LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.

(Geerbt von DataControlField)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnFieldChanged()

Löst das FieldChanged-Ereignis aus.

(Geerbt von DataControlField)
SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.

(Geerbt von DataControlField)
ToString()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.

(Geerbt von DataControlField)
TrackViewState()

Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.

(Geerbt von DataControlField)
ValidateSupportsCallback()

Bestimmt, ob die in einem ButtonField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.

(Geerbt von DataControlField)
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.

(Geerbt von DataControlField)
IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.

(Geerbt von DataControlField)
IStateManager.SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.

(Geerbt von DataControlField)
IStateManager.TrackViewState()

Bewirkt, dass das DataControlField-Objekt Änderungen an seinem Ansichtszustand nachverfolgt, damit diese in der ViewState-Eigenschaft des Steuerelements gespeichert und über mehrere Anforderungen für dieselbe Seite hinweg beibehalten werden.

(Geerbt von DataControlField)

Gilt für:

Weitere Informationen