Exporter (0) Imprimer
Développer tout

CommandField.ShowEditButton, propriété

Remarque : cette propriété est nouvelle dans le .NET Framework version 2.0.

Obtient ou définit une valeur indiquant si un bouton Modifier est affiché dans un champ CommandField.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public virtual bool ShowEditButton { get; set; }
/** @property */
public boolean get_ShowEditButton ()

/** @property */
public void set_ShowEditButton (boolean value)

public function get ShowEditButton () : boolean

public function set ShowEditButton (value : boolean)

Valeur de la propriété

true pour afficher un bouton Modifier dans un CommandField ; sinon, false. La valeur par défaut est false.

Utilisez la propriété ShowEditButton pour spécifier si un bouton Modifier est affiché dans le champ CommandField 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, les contrôles d'entrée sont affichés pour chaque champ dans 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. Un clic sur le bouton Mettre à jour met à jour l'enregistrement avec les nouvelles valeurs dans la source de données alors qu'un clic sur le bouton Annuler annule l'opération.

RemarqueRemarque

Lorsqu'un contrôle lié aux données est utilisé en association avec un contrôle de source de données (tel qu'un contrôle SqlDataSource), le contrôle lié aux données peut bénéficier des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de mise à jour automatique. Pour que d'autres sources de données exécutent l'opération de mise à jour pendant l'événement approprié pour le contrôle lié aux données, vous devez fournir les routines.

Lorsque la propriété ButtonType d'un champ CommandField a la valeur ButtonType.Button ou ButtonType.Link, utilisez la propriété EditText pour spécifier le texte à afficher pour un bouton Modifier. Vous pouvez également afficher une image en affectant d'abord ButtonType.Image à la propriété ButtonType, puis en définissant la propriété EditImageUrl.

L'exemple de code suivant montre comment utiliser la propriété ShowEditButton pour afficher un bouton Modifier pour chaque enregistrement dans un contrôle GridView.


<%@ Page language="C#" %>

<html>
  <body>
    <form 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>


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft