CommandField.InsertImageUrl 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 dirección URL en una imagen que se va a mostrar para el botón Insertar en un CommandField campo.
public:
virtual property System::String ^ InsertImageUrl { System::String ^ get(); void set(System::String ^ value); };public virtual string InsertImageUrl { get; set; }member this.InsertImageUrl : string with get, setPublic Overridable Property InsertImageUrl As StringValor de propiedad
Dirección URL de una imagen que se va a mostrar para el botón Insertar en .CommandField El valor predeterminado es una cadena vacía (""), que indica que esta propiedad no está establecida.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la InsertImageUrl propiedad para especificar una imagen personalizada que se va a mostrar para un botón Insertar en un CommandField campo de un DetailsView control. La ButtonType propiedad debe establecerse en ButtonType.Image para que un botón Insertar muestre una imagen.
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CommandField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CommandField Example</h3>
<asp:detailsview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneraterows="false"
datakeynames="CustomerID"
allowpaging="true"
runat="server">
<fields>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="CompanyName"/>
<asp:boundfield datafield="Address"
headertext="Address"/>
<asp:boundfield datafield="City"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
headertext="Country"/>
<asp:commandfield showinsertbutton="true"
buttontype="Image"
insertimageurl="~\Images\InsertButton.jpg"
newimageurl="~\Images\AddButton.jpg"
cancelimageurl="~\Images\CancelButton.jpg"
showheader="true"
headertext="Add Store"/>
</fields>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values @CustomerID, @CompanyName, @City, @PostalCode, @Country)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>CommandField Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>CommandField Example</h3>
<asp:detailsview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneraterows="false"
datakeynames="CustomerID"
allowpaging="true"
runat="server">
<fields>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="CompanyName"/>
<asp:boundfield datafield="Address"
headertext="Address"/>
<asp:boundfield datafield="City"
headertext="City"/>
<asp:boundfield datafield="PostalCode"
headertext="ZIP Code"/>
<asp:boundfield datafield="Country"
headertext="Country"/>
<asp:commandfield showinsertbutton="true"
buttontype="Image"
insertimageurl="~\Images\InsertButton.jpg"
newimageurl="~\Images\AddButton.jpg"
cancelimageurl="~\Images\CancelButton.jpg"
showheader="true"
headertext="Add Store"/>
</fields>
</asp:detailsview>
<!-- This example uses Microsoft SQL Server and connects -->
<!-- to the Northwind sample database. Use an ASP.NET -->
<!-- expression to retrieve the connection string value -->
<!-- from the Web.config file. -->
<asp:sqldatasource id="CustomersSqlDataSource"
selectcommand="Select [CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country] From [Customers]"
insertcommand="Insert Into [Customers]([CustomerID], [CompanyName], [City], [PostalCode], [Country]) Values (@CustomerID, @CompanyName, @City, @PostalCode, @Country)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Comentarios
Cuando la ButtonType propiedad de un CommandField campo se establece ButtonType.Imageen , use la InsertImageUrl propiedad para especificar la imagen que se va a mostrar para un botón Insertar. Esta imagen puede estar en cualquier formato de archivo (.jpg, .gif, .bmp, etc.), siempre y cuando el explorador del cliente admita ese formato.
Nota:
Como alternativa a mostrar una imagen para el botón Insertar, puede mostrar texto estableciendo primero la ButtonType propiedad en o ButtonType.Link y estableciendo la InsertTextButtonType.Button propiedad.
