ButtonField Klasse

Definition

Stellt ein Feld dar, das als Schaltfläche in einem datengebundenen Steuerelement angezeigt wird.Represents a field that is displayed as a button in a data-bound control.

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 mit Befehls Schaltflächen in einem GridView-Steuerelement anzuzeigen.The following code example demonstrates how to use a ButtonField object to display a column of command buttons in a GridView control.


<%@ 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 Daten gebundenen Steuerelementen (z. b. GridView und DetailsView) verwendet, um eine Schaltfläche für jeden angezeigten Datensatz anzuzeigen.The ButtonField class is used by data-bound controls (such as GridView and DetailsView) to display a button for each record that is displayed. Das ButtonField Objekt wird unterschiedlich angezeigt, je nach dem Daten gebundenen Steuerelement, in dem es verwendet wird.The ButtonField object is displayed differently depending on the data-bound control in which it is used. Das GridView-Steuerelement zeigt z. b. ein ButtonField Objekt als Spalte an, während das DetailsView-Steuerelement es als Zeile anzeigt.For example, the GridView control displays a ButtonField object as a column, while the DetailsView control displays it as a row.

Wenn Sie auf eine Schaltfläche in einem Schaltflächen Feld klicken, wird das Befehls Ereignis des übergeordneten Daten gebundenen Steuer Elements ausgelöst.Clicking a button in a button field raises the command event of the parent data-bound control. Sie können eine benutzerdefinierte Routine bereitstellen, die beim Klicken auf eine Befehls Schaltfläche auszuführen ist, indem Sie einen Ereignishandler für das Befehls Ereignis bereitstellen.You can provide a custom routine to perform when a command button is clicked by providing an event handler for the command event.

Hinweis

Das GridView-Steuerelement löst das RowCommand-Ereignis aus, während das DetailsView-Steuerelement das ItemCommand Ereignis auslöst.The GridView control raises the RowCommand event, while the DetailsView control raises the ItemCommand event.

Um den Index des Datensatzes zu bestimmen, der das Befehls Ereignis auslöst, verwenden Sie die CommandArgument-Eigenschaft des Ereignis Arguments, das an das-Befehls Ereignis für das Daten gebundene Steuerelement übermittelt wird.To determine the index of the record that raises the command event, use the CommandArgument property of the event argument that is passed to the command event for the data-bound control. Die ButtonField-Klasse füllt automatisch die CommandArgument-Eigenschaft mit dem entsprechenden Indexwert auf.The ButtonField class automatically populates the CommandArgument property with the appropriate index value.

Um den Typ der anzuzeigenden Schaltfläche anzugeben, verwenden Sie die ButtonType-Eigenschaft.To specify the type of button to display, use the ButtonType property. Wenn Sie eine Verknüpfung oder Befehls Schaltfläche anzeigen, verwenden Sie die Text-Eigenschaft, um die in den Schaltflächen anzuzeigende Beschriftung anzugeben.When displaying a link or command button, use the Text property to specify the caption to display in the buttons.

Hinweis

Wenn Sie die Text-Eigenschaft festlegen, haben alle Schaltflächen in einer ButtonField dieselbe Beschriftung.If you set the Text property, all buttons in a ButtonField share the same caption.

Alternativ können Sie das ButtonField-Objekt an ein Feld in einer Datenquelle binden.Alternatively, you can bind the ButtonField object to a field in a data source. Auf diese Weise können Sie unterschiedliche Beschriftungen für die Schaltflächen im ButtonField Objekt anzeigen.This allows you to display different captions for the buttons in the ButtonField object. Die Werte im angegebenen Feld werden für die Text Beschriftungen der Schaltflächen verwendet.The values that are in the specified field are used for the text captions of the buttons. Legen Sie die DataTextField-Eigenschaft fest, um ein ButtonField Objekt an ein Feld in einer Datenquelle zu binden.Set the DataTextField property to bind a ButtonField object to a field in a data source.

Wenn Sie die Schaltfläche Bild anzeigen, verwenden Sie die ImageUrl-Eigenschaft, um das Bild anzugeben, das für die Schaltflächen im ButtonField-Objekt angezeigt werden soll.When displaying an image button, use the ImageUrl property to specify the image to display for the buttons in the ButtonField object.

Hinweis

Alle Schaltflächen in einem ButtonField Objekt haben dasselbe Bild gemeinsam.All buttons in a ButtonField object share the same image.

Sie können ein ButtonField Objekt in einem Daten gebundenen Steuerelement ausblenden, indem Sie die Eigenschaft Visible auf falsefestlegen.You can hide a ButtonField object in a data-bound control by setting the Visible property to false.

Mit dem ButtonField-Objekt können Sie die Kopf-und Fußzeilen Abschnitte anpassen.The ButtonField object allows you to customize its header and footer sections. Um eine Beschriftung in der Kopf- oder Fußzeile Abschnitt anzuzeigen, legen die HeaderText oder FooterText Eigenschaften bzw.To display a caption in the header or footer section, set the HeaderText or FooterText properties, respectively. Anstatt Text im Header Abschnitt anzuzeigen, können Sie ein Bild anzeigen, indem Sie die HeaderImageUrl-Eigenschaft festlegen.Instead of displaying text in the header section, you can display an image by setting the HeaderImageUrl property. Um den Header Abschnitt in einem ButtonField Objekt auszublenden, legen Sie die Eigenschaft ShowHeader auf falsefest.To hide the header section in a ButtonField object, set the ShowHeader property to false.

Hinweis

Einige Daten gebundene Steuerelemente (z. b. das GridView-Steuerelement) können nur den gesamten Header Abschnitt des Steuer Elements anzeigen oder ausblenden.Some data-bound controls (such as the GridView control) can show or hide only the entire header section of the control. Diese Daten gebundenen Steuerelemente unterstützen die ShowHeader-Eigenschaft für ein einzelnes Schaltflächen Feld nicht.These data-bound controls do not support the ShowHeader property for an individual button field. Um den gesamten Header Abschnitt eines Daten gebundenen Steuer Elements (falls verfügbar) anzuzeigen oder auszublenden, verwenden Sie die ShowHeader-Eigenschaft für das Steuerelement.To show or hide the entire header section of a data-bound control (if available), use the ShowHeader property for the control.

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.You also can customize the appearance of the ButtonField object (font color, background color, and so on) by setting the style properties for the different parts of the field. In der folgenden Tabelle werden die verschiedenen Stileigenschaften aufgelistet.The following table lists the different style properties.

Style-EigenschaftStyle property Die Stileinstellungen fürThe style settings for
ControlStyle Die untergeordneten Webserver-Steuerelemente der ButtonField.The child Web server controls of the ButtonField.
FooterStyle Der Footerbereich der ButtonField.The footer section of the ButtonField.
HeaderStyle Der Header Abschnitt der ButtonField.The header section of the ButtonField.
ItemStyle Die Datenelemente in der ButtonField.The data items in the ButtonField.

Konstruktoren

ButtonField()

Initialisiert eine neue Instanz der ButtonField-Klasse.Initializes a new instance of the ButtonField class.

Eigenschaften

AccessibleHeaderText

Ruft Text ab, der in einigen Steuerelementen als AbbreviatedText-Eigenschaftswert gerendert wird, oder legt diesen fest.Gets or sets text that is rendered as the AbbreviatedText property value in some controls.

(Geerbt von DataControlField)
ButtonType

Ruft den Schaltflächentyp ab, der im Schaltflächenfeld angezeigt werden soll, oder legt diesen fest.Gets or sets the button type to display in the button field.

(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.Gets or sets a value indicating whether validation is performed when a button in a ButtonFieldBase object is clicked.

(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.Gets or sets a string that represents the action to perform when a button in a ButtonField object is clicked.

Control

Ruft einen Verweis auf das Datensteuerelement ab, dem das DataControlField-Objekt zugeordnet ist.Gets a reference to the data control that the DataControlField object is associated with.

(Geerbt von DataControlField)
ControlStyle

Ruft den Stil aller im DataControlField-Objekt enthaltenen Webserver-Steuerelemente ab.Gets the style of any Web server controls contained by the DataControlField object.

(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.Gets or sets the name of the data field for which the value is bound to the Text property of the Button control that is rendered by the ButtonField object.

DataTextFormatString

Ruft die Zeichenfolge ab, die das Anzeigeformat für den Wert des Felds angibt, oder legt diese fest.Gets or sets the string that specifies the display format for the value of the field.

DesignMode

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld derzeit in einer Entwurfszeitumgebung angezeigt wird.Gets a value indicating whether a data control field is currently viewed in a design-time environment.

(Geerbt von DataControlField)
FooterStyle

Ruft den Stil der Fußzeile des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the footer of the data control field.

(Geerbt von DataControlField)
FooterText

Ruft den Text ab, der im Fußzeilenelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the footer item of a data control field.

(Geerbt von DataControlField)
HeaderImageUrl

Ruft die URL zu einem Bild ab, das im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diese fest.Gets or sets the URL of an image that is displayed in the header item of a data control field.

(Geerbt von DataControlField)
HeaderStyle

Ruft den Stil des Headers des Datensteuerelement-Felds ab oder legt diesen fest.Gets or sets the style of the header of the data control field.

(Geerbt von DataControlField)
HeaderText

Ruft den Text ab, der im Headerelement eines Datensteuerelement-Felds angezeigt werden soll, oder legt diesen fest.Gets or sets the text that is displayed in the header item of a data control field.

(Geerbt von DataControlField)
ImageUrl

Ruft das Bild ab, das für jede Schaltfläche im ButtonField-Objekt angezeigt werden soll, oder legt dieses fest.Gets or sets the image to display for each button in the ButtonField object.

InsertVisible

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt angezeigt wird, wenn sich sein übergeordnetes datengebundenes Steuerelement im Einfügemodus befindet.Gets a value indicating whether the DataControlField object is visible when its parent data-bound control is in insert mode.

(Geerbt von DataControlField)
IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Geerbt von DataControlField)
ItemStyle

Ruft das Format von allen textbasierten Inhalten ab, die von einem Datensteuerelement-Feld angezeigt werden.Gets the style of any text-based content displayed by a data control field.

(Geerbt von DataControlField)
ShowHeader

Ruft einen Wert ab, der angibt, ob der Headerbereich in einem ButtonFieldBase-Objekt angezeigt wird, oder legt diesen Wert fest.Gets or sets a value indicating whether the header section is displayed in a ButtonFieldBase object.

(Geerbt von ButtonFieldBase)
SortExpression

Ruft einen Sortierausdruck ab, mit dem ein Datenquellen-Steuerelement Daten sortiert, oder legt diesen fest.Gets or sets a sort expression that is used by a data source control to sort data.

(Geerbt von DataControlField)
Text

Ruft die statische Beschriftung ab, die für jede Schaltfläche im ButtonField-Objekt angezeigt wird, oder legt diese fest.Gets or sets the static caption that is displayed for each button in the ButtonField object.

ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben überprüft.Gets or sets a value that specifies whether the control validates client input.

(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.Gets or sets the name of the group of validation controls to validate when a button in a ButtonFieldBase object is clicked.

(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.Gets a dictionary of state information that allows you to save and restore the view state of a DataControlField object across multiple requests for the same page.

(Geerbt von DataControlField)
Visible

Ruft einen Wert ab, der angibt, ob ein Datensteuerelement-Feld dargestellt werden soll, oder legt diesen fest.Gets or sets a value indicating whether a data control field is rendered.

(Geerbt von DataControlField)

Methoden

CloneField()

Erstellt eine doppelte Kopie des aktuellen, von DataControlField abgeleiteten Objekts.Creates a duplicate copy of the current DataControlField-derived object.

(Geerbt von DataControlField)
CopyProperties(DataControlField)

Kopiert die Eigenschaften des aktuellen ButtonField-Objekts in das angegebene DataControlField-Objekt.Copies the properties of the current ButtonField object to the specified DataControlField object.

CreateField()

Erstellt und gibt eine neue Instanz der ButtonField-Klasse zurück.Creates and returns a new instance of the ButtonField class.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(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.Extracts the value of the data control field from the current table cell and adds the value to the specified IDictionary collection.

(Geerbt von DataControlField)
FormatDataTextValue(Object)

Formatiert den angegebenen Feldwert für eine Zelle im ButtonField-Objekt.Formats the specified field value for a cell in the ButtonField object.

GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
Initialize(Boolean, Control)

Initialisiert das aktuelle ButtonField-Objekt.Initializes the current ButtonField object.

InitializeCell(DataControlFieldCell, DataControlCellType, DataControlRowState, Int32)

Initialisiert das angegebene DataControlFieldCell-Objekt mit dem angegebenen Zeilenzustand.Initializes the specified DataControlFieldCell object to the specified row state.

LoadViewState(Object)

Stellt den früher gespeicherten Ansichtszustand der Datenquellenansicht wieder her.Restores the data source view's previously saved view state.

(Geerbt von DataControlField)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
OnFieldChanged()

Löst das FieldChanged-Ereignis aus.Raises the FieldChanged event.

(Geerbt von DataControlField)
SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(Geerbt von DataControlField)
ToString()

Gibt eine Zeichenfolge zurück, die dieses DataControlField-Objekt darstellt.Returns a string that represents this DataControlField object.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Geerbt von DataControlField)
ValidateSupportsCallback()

Bestimmt, ob die in einem ButtonField-Objekt enthaltenen Steuerelemente Rückrufe unterstützen.Determines whether the controls that are contained in a ButtonField object support callbacks.

Explizite Schnittstellenimplementierungen

IDataSourceViewSchemaAccessor.DataSourceViewSchema

Ruft das Schema ab, das diesem DataControlField-Objekt zugeordnet ist, oder legt es fest.Gets or sets the schema associated with this DataControlField object.

(Geerbt von DataControlField)
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das DataControlField-Objekt Änderungen des Ansichtszustands speichert.Gets a value indicating whether the DataControlField object is saving changes to its view state.

(Geerbt von DataControlField)
IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand des Datensteuerelement-Felds wieder her.Restores the data control field's previously saved view state.

(Geerbt von DataControlField)
IStateManager.SaveViewState()

Speichert die Änderungen am DataControlField-Ansichtszustand ab dem Zeitpunkt, an dem die Seite an den Server zurückgesendet wurde.Saves the changes made to the DataControlField view state since the time the page was posted back to the server.

(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.Causes the DataControlField object to track changes to its view state so they can be stored in the control's ViewState property and persisted across requests for the same page.

(Geerbt von DataControlField)

Gilt für:

Siehe auch