CommandField.ShowEditButton 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 une valeur indiquant si un bouton Modifier est affiché dans un champ CommandField.
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 BooleanValeur de propriété
true pour afficher un bouton Modifier dans un CommandField ; sinon, false. La valeur par défaut est false.
Exemples
L’exemple de code suivant montre comment utiliser la ShowEditButton propriété pour afficher un bouton Modifier pour chaque enregistrement dans un GridView contrôle.
<%@ 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>
Remarques
Utilisez la ShowEditButton propriété pour spécifier si un bouton Modifier s’affiche dans le CommandField champ pour chaque enregistrement du contrôle de source de données. Le bouton Modifier vous permet de modifier les valeurs d’un enregistrement.
Lorsque l’utilisateur clique sur un bouton Modifier, des contrôles d’entrée s’affichent pour chaque champ de l’enregistrement. Le bouton Modifier de l’enregistrement est remplacé par un bouton Mettre à jour et un bouton Annuler, et tous les autres boutons de commande de l’enregistrement sont masqués. Cliquer sur le bouton Mettre à jour met à jour l’enregistrement avec les nouvelles valeurs dans la source de données, tandis que cliquer sur le bouton Annuler annule l’opération.
Notes
Lorsqu’un contrôle lié aux données est utilisé en combinaison avec un contrôle de source de données (tel qu’un SqlDataSource contrôle), le contrôle lié aux données peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de mise à jour automatique. Pour les autres sources de données, vous devez fournir les routines permettant d’effectuer l’opération de mise à jour pendant l’événement approprié pour le contrôle lié aux données.
Lorsque la ButtonType propriété d’un CommandField champ est définie sur ButtonType.Button ou ButtonType.Link, utilisez la EditText propriété pour spécifier le texte à afficher pour un bouton Modifier. Vous pouvez également afficher une image en définissant d’abord la ButtonType propriété sur ButtonType.Image , puis en définissant la EditImageUrl propriété.
