ButtonField.ImageUrl Propriedade

Definição

Obtém ou define a imagem a ser exibida para cada botão no objeto ButtonField.Gets or sets the image to display for each button in the ButtonField object.

public:
 virtual property System::String ^ ImageUrl { System::String ^ get(); void set(System::String ^ value); };
public virtual string ImageUrl { get; set; }
member this.ImageUrl : string with get, set
Public Overridable Property ImageUrl As String

Valor da propriedade

String

A imagem a ser exibida para cada botão no ButtonField.The image to display for each button in the ButtonField. O padrão é uma cadeia de caracteres vazia (""), que indica que a propriedade ImageUrl não está definida.The default is an empty string (""), which indicates that the ImageUrl property is not set.

Exemplos

O exemplo de código a seguir demonstra como usar a ImageUrl propriedade para especificar uma imagem a ser exibida para cada botão no ButtonField objeto.The following code example demonstrates how to use the ImageUrl property to specify an image to display for each button in the ButtonField object. Para este exemplo de código a ser exibido, você deve fornecer sua própria imagem.For this code example to display, you must provide your own image.


<%@ 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 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>ButtonField ImageUrl Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField ImageUrl Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Set the ImageUrl property of the ButtonField declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Image" 
            commandname="Select"
            headertext="Select Author"
            ImageUrl="~\images\ButtonImage.jpg"/>
          <asp:boundfield datafield="ContactName" 
            headertext="ContactName"/>
          <asp:boundfield datafield="ContactTitle" 
            headertext="ContactTitle"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [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 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>ButtonField ImageUrl Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>ButtonField ImageUrl Example</h3>
      
      <asp:label id="Message"
        forecolor="Red"
        runat="server"
        AssociatedControlID="CustomersGridView"/>
                    
      <!-- Set the ImageUrl property of the ButtonField declaratively. -->
      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSqlDataSource" 
        autogeneratecolumns="false"
        onrowcommand="CustomersGridView_RowCommand"
        runat="server">
                
        <columns>
                
          <asp:buttonfield buttontype="Image" 
            commandname="Select"
            headertext="Select Author"
            ImageUrl="~\images\ButtonImage.jpg"/>
          <asp:boundfield datafield="ContactName" 
            headertext="ContactName"/>
          <asp:boundfield datafield="ContactTitle" 
            headertext="ContactTitle"/>
                
        </columns>
                
      </asp:gridview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Northwind sample database.                   -->
        <asp:sqldatasource id="CustomersSqlDataSource"  
          selectcommand="Select [CustomerID], [ContactName], [ContactTitle] From [Customers]"
          connectionstring="<%$ ConnectionStrings:NorthWindConnection%>"
          runat="server">
        </asp:sqldatasource>
            
    </form>
  </body>
</html>

Comentários

Quando a ButtonType propriedade de um ButtonField objeto é definida como o Image valor, use a ImageUrl propriedade para especificar a imagem a ser exibida para cada botão.When the ButtonType property of a ButtonField object is set to the Image value, use the ImageUrl property to specify the image to display for each button. Essa imagem pode estar em qualquer formato de arquivo (. jpg,. gif,. bmp e assim por diante), desde que o navegador do cliente dê suporte a esse formato.This image can be in any file format (.jpg, .gif, .bmp, and so on), as long as the client browser supports that format.

O valor dessa propriedade é armazenado em estado de exibição.The value of this property is stored in view state.

Aplica-se a