CommandField.ShowEditButton Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine Bearbeitungsschaltfläche in einem CommandField Feld angezeigt wird.
public:
virtual property bool ShowEditButton { bool get(); void set(bool value); };public virtual bool ShowEditButton { get; set; }member this.ShowEditButton : bool with get, setPublic Overridable Property ShowEditButton As BooleanEigenschaftswert
true zum Anzeigen einer Bearbeitungsschaltfläche in einem CommandField; andernfalls false. Der Standardwert lautet false.
Beispiele
Im folgenden Codebeispiel wird veranschaulicht, wie die ShowEditButton Eigenschaft zum Anzeigen einer Bearbeitungsschaltfläche für jeden Datensatz in einem GridView Steuerelement verwendet wird.
<%@ 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:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:commandfield showeditbutton="true"
buttontype="Image"
editimageurl="~\Images\EditButton.jpg"
cancelimageurl="~\Images\CancelButton.jpg"
updateimageurl="~\Images\UpdateButton.jpg"
headertext="Edit Controls"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<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"/>
</columns>
</asp:gridview>
<!-- 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]"
updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
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">
<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:gridview id="CustomersGridView"
datasourceid="CustomersSqlDataSource"
autogeneratecolumns="false"
datakeynames="CustomerID"
runat="server">
<columns>
<asp:commandfield showeditbutton="true"
buttontype="Image"
editimageurl="~\Images\EditButton.jpg"
cancelimageurl="~\Images\CancelButton.jpg"
updateimageurl="~\Images\UpdateButton.jpg"
headertext="Edit Controls"/>
<asp:boundfield datafield="CustomerID"
headertext="Customer ID" />
<asp:boundfield datafield="CompanyName"
headertext="Company Name"/>
<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"/>
</columns>
</asp:gridview>
<!-- 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]"
updatecommand="Update Customers Set CompanyName=@CompanyName, Address=@Address, City=@City, PostalCode=@PostalCode, Country=@Country Where (CustomerID = @CustomerID)"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
Hinweise
Verwenden Sie die ShowEditButton Eigenschaft, um anzugeben, ob eine Schaltfläche "Bearbeiten" im CommandField Feld für jeden Datensatz im Datenquellensteuerelement angezeigt wird. Mit der Schaltfläche "Bearbeiten" können Sie die Werte eines Datensatzes bearbeiten.
Wenn der Benutzer auf eine Schaltfläche "Bearbeiten" klickt, werden eingabesteuerelemente für jedes Feld im Datensatz angezeigt. Die Schaltfläche "Bearbeiten" für den Datensatz wird durch eine Schaltfläche "Aktualisieren" und eine Schaltfläche "Abbrechen" ersetzt, und alle anderen Befehlsschaltflächen für den Datensatz werden ausgeblendet. Durch Klicken auf die Schaltfläche "Aktualisieren" wird der Datensatz mit den neuen Werten in der Datenquelle aktualisiert, während durch Klicken auf die Schaltfläche "Abbrechen" der Vorgang abgebrochen wird.
Hinweis
Wenn ein datengebundenes Steuerelement in Kombination mit einem Datenquellensteuerelement (z. B. einem SqlDataSource Steuerelement) verwendet wird, kann das datengebundene Steuerelement die Funktionen des Datenquellensteuerelements nutzen und automatische Aktualisierungsfunktionen bereitstellen. Für andere Datenquellen müssen Sie die Routinen angeben, um den Aktualisierungsvorgang während des entsprechenden Ereignisses für das datengebundene Steuerelement auszuführen.
Wenn die ButtonType Eigenschaft eines CommandField Felds auf ButtonType.Button oder ButtonType.Link, verwenden Sie die EditText Eigenschaft, um den Text anzugeben, der für eine Bearbeitungsschaltfläche angezeigt werden soll. Alternativ können Sie ein Bild anzeigen, indem Sie zuerst die ButtonType Eigenschaft auf ButtonType.Image und dann die EditImageUrl Eigenschaft festlegen.
