ButtonField.ImageUrl Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit l'image à afficher pour chaque bouton dans l'objet 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 StringValeur de propriété
Image à afficher pour chaque bouton dans ButtonField. La valeur par défaut est une chaîne vide (" "), ce qui signifie que la propriété ImageUrl n'est pas définie.
Exemples
L’exemple de code suivant montre comment utiliser la ImageUrl propriété pour spécifier une image à afficher pour chaque bouton de l’objet ButtonField . Pour que cet exemple de code s’affiche, vous devez fournir votre propre 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>
Remarques
Lorsque la ButtonType propriété d’un ButtonField objet est définie sur la Image valeur, utilisez la propriété pour spécifier l’image ImageUrl à afficher pour chaque bouton. Cette image peut être dans n’importe quel format de fichier (.jpg, .gif, .bmp, et ainsi de suite), tant que le navigateur client prend en charge ce format.
La valeur de cette propriété est stockée dans l’état d’affichage.