Share via

ButtonFieldBase.ButtonType Propiedad

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

Obtiene o establece el tipo de botón que se va a mostrar en el campo de botón.

public:
 virtual property System::Web::UI::WebControls::ButtonType ButtonType { System::Web::UI::WebControls::ButtonType get(); void set(System::Web::UI::WebControls::ButtonType value); };
public virtual System.Web.UI.WebControls.ButtonType ButtonType { get; set; }
member this.ButtonType : System.Web.UI.WebControls.ButtonType with get, set
Public Overridable Property ButtonType As ButtonType

Valor de propiedad

ButtonType

Uno de los valores de ButtonType. De manera predeterminada, es ButtonType.Link.

Excepciones

ArgumentOutOfRangeException

El valor de la propiedad ButtonType no es uno de los valores de ButtonType.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar la ButtonType propiedad para especificar que los botones se muestran en el ButtonField objeto de un GridView control.

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

<script runat="server">

  void AuthorsGridView_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 = AuthorsGridView.Rows[index];
      TableCell lastNameCell = selectedRow.Cells[1];
      string lastName = lastNameCell.Text;  
    
      // Display the selected author.
      Message.Text = "You selected " + lastName + ".";
      
    }
    
  }
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ButtonFieldBase ButtonType Example</title>
</head>
<body>
  <form id="form1" runat="server">
  <div>

    <h3>ButtonFieldBase ButtonType Example</h3>

    <asp:label id="Message"
      forecolor="Red"
      runat="server"
      AssociatedControlID="AuthorsGridView" />
                    
    <!-- Populate the Columns collection declaratively. -->
    <asp:gridview id="AuthorsGridView" 
      datasourceid="AuthorsSqlDataSource" 
      autogeneratecolumns="false"
      onrowcommand="AuthorsGridView_RowCommand" 
      runat="server">
                
      <columns>
        <asp:buttonfield buttontype="Button" 
          commandname="Select"
          headertext="Select Author" 
          text="Select"/>
        <asp:boundfield datafield="au_lname" 
          headertext="Last Name"/>
        <asp:boundfield datafield="au_fname" 
          headertext="First Name"/>
      </columns>
                
    </asp:gridview>
            
    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Pubs sample database. -->
    <asp:sqldatasource id="AuthorsSqlDataSource"  
      selectcommand="SELECT [au_lname], [au_fname] FROM [authors]"
      connectionstring="server=localhost;database=pubs;integrated security=SSPI"
      runat="server">
    </asp:sqldatasource>

  </div>
  </form>
</body>
</html>


<%@ Page language="VB" %>

<script runat="server">

  Sub AuthorsGridView_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 = AuthorsGridView.Rows(index)
      Dim lastNameCell As TableCell = selectedRow.Cells(1)
      Dim lastName As String = lastNameCell.Text
    
      ' Display the selected author.
      Message.Text = "You selected " & lastName & "."
      
    End If
    
  End Sub
    
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>ButtonFieldBase ButtonType Example</title>
</head>
<body>
  <form id="form1" runat="server">
  <div>
        
    <h3>ButtonFieldBase ButtonType Example</h3>

    <asp:label id="Message"
      forecolor="Red"
      runat="server"
      AssociatedControlID="AuthorsGridView"/>

    <!-- Populate the Columns collection declaratively. -->
    <asp:gridview id="AuthorsGridView" 
      datasourceid="AuthorsSqlDataSource" 
      autogeneratecolumns="false"
      onrowcommand="AuthorsGridView_RowCommand"
      runat="server">

      <columns>
        <asp:buttonfield buttontype="Button" 
          commandname="Select"
          headertext="Select Author" 
          text="Select"/>
        <asp:boundfield datafield="au_lname" 
          headertext="Last Name"/>
        <asp:boundfield datafield="au_fname" 
          headertext="First Name"/>
      </columns>

    </asp:gridview>

    <!-- This example uses Microsoft SQL Server and connects -->
    <!-- to the Pubs sample database.                        -->
    <asp:sqldatasource id="AuthorsSqlDataSource"  
      selectcommand="SELECT [au_lname], [au_fname] FROM [authors]"
      connectionstring="server=localhost;database=pubs;integrated security=SSPI"
      runat="server">
    </asp:sqldatasource>

  </div>
  </form>
</body>
</html>

Comentarios

Utilice la ButtonType propiedad para especificar qué tipo de botón se muestra en un campo de botón. En la tabla siguiente se enumeran los tipos de botón disponibles.

Valor de tipo de botón Muestra como
Button Control de botón.
Image Un botón con una imagen.
Link Vínculo.

El valor de esta propiedad se almacena en estado de vista.

Se aplica a

Consulte también