CommandField.InsertImageUrl Eigenschaft

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Ruft die URL zu einem Bild ab, das für die Einfügen-Schaltfläche in einem CommandField-Feld angezeigt werden soll, oder legt diese fest.

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, set
Public Overridable Property InsertImageUrl As String

Eigenschaftswert

String

Die URL zu einem Bild, das für die Einfügen-Schaltfläche in einem CommandField angezeigt werden soll. Der Standardwert ist eine leere Zeichenfolge ("") und gibt an, dass diese Eigenschaft nicht festgelegt ist.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe der InsertImageUrl -Eigenschaft ein benutzerdefiniertes Bild angeben, das für eine Einfügen-Schaltfläche in einem CommandField Feld eines DetailsView Steuerelements angezeigt werden soll. Die ButtonType -Eigenschaft muss auf ButtonType.Image festgelegt werden, damit eine Einfügen-Schaltfläche ein Bild anzeigt.


<%@ 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>

Hinweise

Wenn die ButtonType Eigenschaft eines CommandField Felds auf ButtonType.Imagefestgelegt ist, verwenden Sie die InsertImageUrl -Eigenschaft, um das Bild anzugeben, das für eine Einfügen-Schaltfläche angezeigt werden soll. Dieses Bild kann in einem beliebigen Dateiformat (.jpg, .gif, .bmp usw.) vorliegen, solange der Browser des Clients dieses Format unterstützt.

Hinweis

Alternativ zum Anzeigen eines Bilds für die Schaltfläche Einfügen können Sie Text anzeigen, indem Sie zuerst die ButtonType Eigenschaft auf ButtonType.Button oder ButtonType.Link festlegen und dann die InsertText Eigenschaft festlegen.

Gilt für:

Weitere Informationen