ButtonField Klasse

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.

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

DataControlField

ButtonFieldBase
ButtonField

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ein ButtonField Objekt verwendet wird, um eine Spalte mit 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 das DetailsView Steuerelement es als Zeile anzeigt.

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

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 ermitteln, 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 ButtonType Eigenschaft, um den Anzuzeigenden Schaltflächentyp anzugeben. Verwenden Sie beim Anzeigen eines Links oder einer Befehlsschaltfläche die Text Eigenschaft, um die Beschriftung anzugeben, die in den Schaltflächen angezeigt werden soll.

Hinweis

Wenn Sie die Text Eigenschaft festlegen, verwenden alle Schaltflächen in einer ButtonField Beschriftung dieselbe Beschriftung.

Alternativ können Sie das ButtonField Objekt an ein Feld in einer Datenquelle binden. Auf diese Weise 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 verwenden dasselbe Bild.

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

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

Hinweis

Einige datengebundene Steuerelemente (z. B. das GridView Steuerelement) können nur den gesamten Kopfzeilenabschnitt des Steuerelements ein- oder ausblenden. Diese datengebundenen Steuerelemente unterstützen die ShowHeader Eigenschaft für ein einzelnes Schaltflächenfeld nicht. Verwenden Sie die ShowHeader Eigenschaft für das Steuerelement, um den gesamten Kopfzeilenabschnitt 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 Formateigenschaften für die verschiedenen Teile des Felds festlegen. In der folgenden Tabelle sind die verschiedenen Formateigenschaften aufgeführt.

Style-Eigenschaft	Die Formatvorlageneinstellungen für
ControlStyle	Die untergeordneten Webserversteuerelemente der ButtonField.
FooterStyle	Der Fußzeilenabschnitt des ButtonField.
HeaderStyle	Der Kopfzeilenabschnitt des ButtonField.
ItemStyle	Die Datenelemente in der ButtonField.

Konstruktoren

Name	Beschreibung
ButtonField()	Initialisiert eine neue Instanz der ButtonField-Klasse.

Eigenschaften

Name	Beschreibung
AccessibleHeaderText	Dient zum Abrufen oder Festlegen von Text, der `AbbreviatedText` in einigen Steuerelementen als Eigenschaftswert gerendert wird. (Geerbt von DataControlField)
ButtonType	Dient zum Abrufen oder Festlegen des Schaltflächentyps, der im Schaltflächenfeld angezeigt werden soll. (Geerbt von ButtonFieldBase)
CausesValidation	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Überprüfung ausgeführt wird, wenn auf eine Schaltfläche in einem ButtonFieldBase Objekt geklickt wird. (Geerbt von ButtonFieldBase)
CommandName	Dient zum Abrufen oder Festlegen einer Zeichenfolge, die die auszuführende Aktion darstellt, wenn auf eine Schaltfläche in einem ButtonField Objekt geklickt wird.
Control	Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField Objekt zugeordnet ist. (Geerbt von DataControlField)
ControlStyle	Ruft den Stil aller Webserversteuerelemente ab, die im DataControlField Objekt enthalten sind. (Geerbt von DataControlField)
DataTextField	Dient zum Abrufen oder Festlegen des Namens des Datenfelds, für das der Wert an die Text Eigenschaft des Button Steuerelements gebunden ist, das vom ButtonField Objekt gerendert wird.
DataTextFormatString	Dient zum Abrufen oder Festlegen der Zeichenfolge, die das Anzeigeformat für den Wert des Felds angibt.
DesignMode	Ruft einen Wert ab, der angibt, ob ein Datensteuerelementfeld derzeit in einer Entwurfszeitumgebung angezeigt wird. (Geerbt von DataControlField)
FooterStyle	Dient zum Abrufen oder Festlegen der Formatvorlage der Fußzeile des Datensteuerelementfelds. (Geerbt von DataControlField)
FooterText	Dient zum Abrufen oder Festlegen des Texts, der im Fußzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
HeaderImageUrl	Dient zum Abrufen oder Festlegen der URL eines Bilds, das im Kopfzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
HeaderStyle	Dient zum Abrufen oder Festlegen des Stils der Kopfzeile des Datensteuerelementfelds. (Geerbt von DataControlField)
HeaderText	Dient zum Abrufen oder Festlegen des Texts, der im Kopfzeilenelement eines Datensteuerelementfelds angezeigt wird. (Geerbt von DataControlField)
ImageUrl	Ruft ab oder legt das Bild fest, das für jede Schaltfläche im ButtonField Objekt angezeigt werden soll.
InsertVisible	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt sichtbar ist, wenn sich das übergeordnete datengebundene Steuerelement im Einfügemodus befindet. (Geerbt von DataControlField)
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField)
ItemStyle	Ruft das Format aller textbasierten Inhalte ab, die von einem Datensteuerelementfeld angezeigt werden. (Geerbt von DataControlField)
ShowHeader	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Kopfzeilenabschnitt in einem ButtonFieldBase Objekt angezeigt wird. (Geerbt von ButtonFieldBase)
SortExpression	Dient zum Abrufen oder Festlegen eines Sortierausdrucks, der von einem Datenquellensteuerelement zum Sortieren von Daten verwendet wird. (Geerbt von DataControlField)
Text	Dient zum Abrufen oder Festlegen der statischen Beschriftung, die für jede Schaltfläche im ButtonField Objekt angezeigt wird.
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement die Clienteingabe überprüft. (Geerbt von DataControlField)
ValidationGroup	Dient zum Abrufen oder Festlegen des Namens der Gruppe der Überprüfungssteuerelemente, die überprüft werden sollen, wenn auf eine Schaltfläche in einem ButtonFieldBase Objekt geklickt wird. (Geerbt von ButtonFieldBase)
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines DataControlField Objekts über mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von DataControlField)
Visible	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Datensteuerelementfeld gerendert wird. (Geerbt von DataControlField)

Methoden

Name	Beschreibung
CloneField()	Erstellt eine duplizierte Kopie des aktuellen DataControlFieldabgeleiteten 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 dem aktuellen Objekt entspricht. (Geerbt von Object)
ExtractValuesFromCell(IOrderedDictionary, DataControlFieldCell, DataControlRowState, Boolean)	Extrahiert den Wert des Datensteuerelementfelds 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()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die 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 in den angegebenen Zeilenzustand.
LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der Datenquellenansicht wieder her. (Geerbt von DataControlField)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnFieldChanged()	Löst das `FieldChanged`-Ereignis aus. (Geerbt von DataControlField)
SaveViewState()	Speichert die am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet 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 am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField)
ValidateSupportsCallback()	Bestimmt, ob die steuerelemente, die in einem ButtonField Objekt enthalten sind, Rückrufe unterstützen.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IDataSourceViewSchemaAccessor.DataSourceViewSchema	Ruft das diesem DataControlField Objekt zugeordnete Schema ab oder legt es fest. (Geerbt von DataControlField)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das DataControlField Objekt Änderungen am Ansichtszustand speichert. (Geerbt von DataControlField)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelementfelds wieder her. (Geerbt von DataControlField)
IStateManager.SaveViewState()	Speichert die am Ansichtszustand DataControlField vorgenommenen Änderungen seit dem Zeitpunkt, an dem die Seite zurück auf den Server gepostet wurde. (Geerbt von DataControlField)
IStateManager.TrackViewState()	Bewirkt, dass das DataControlField Objekt Änderungen am Ansichtszustand nachverfolgt, sodass sie in der Eigenschaft des Steuerelements ViewState gespeichert und über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von DataControlField)

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?

Freigeben über

ButtonField Klasse

Definition

Beispiele

Hinweise

Konstruktoren

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für:

Weitere Informationen

Feedback