ButtonField.ImageUrl Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece la imagen que se muestra para cada botón del objeto ButtonField.
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, setPublic Overridable Property ImageUrl As StringValor de propiedad
La imagen que se muestra para cada botón de ButtonField. El valor predeterminado es una cadena vacía (""), lo que indica que no se ha establecido la propiedad ImageUrl.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la ImageUrl propiedad para especificar una imagen que se va a mostrar para cada botón del ButtonField objeto . Para que se muestre este ejemplo de código, debe proporcionar su propia imagen.
<%@ 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>
Comentarios
Cuando la ButtonType propiedad de un ButtonField objeto se establece en el Image valor , utilice la ImageUrl propiedad para especificar la imagen que se va a mostrar para cada botón. Esta imagen puede estar en cualquier formato de archivo (.jpg, .gif, .bmp, etc.), siempre y cuando el explorador cliente admita ese formato.
El valor de esta propiedad se almacena en estado de vista.