Exporter (0) Imprimer
Développer tout

CommandField.ShowInsertButton, propriété

Mise à jour : novembre 2007

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

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

public virtual bool ShowInsertButton { get; set; }
/** @property */
public boolean get_ShowInsertButton()
/** @property */
public  void set_ShowInsertButton(boolean value)

public function get ShowInsertButton () : boolean
public function set ShowInsertButton (value : boolean)

Valeur de propriété

Type : System.Boolean

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

Utilisez la propriété ShowInsertButton pour spécifier si un bouton Nouveau est affiché dans un champ CommandField. Le bouton Nouveau est affiché une seule fois dans le champ CommandField et permet à l'utilisateur d'ajouter un nouvel enregistrement dans la source de données.

Remarque :

Cette propriété s'applique uniquement à des contrôles liés aux données qui prennent en charge des opérations d'insertion, comme le contrôle DetailsView.

Lorsque l'utilisateur clique sur le bouton Nouveau, les contrôles d'entrée sont affichés pour chaque champ affiché dans le contrôle lié aux données, permettant à l'utilisateur d'entrer les valeurs du nouvel enregistrement. Le bouton Nouveau est remplacé par un bouton Insertion et un bouton Annuler, et tous les autres boutons de commande dans le champ CommandField sont masqués. Un clic sur le bouton Insérer ajoute l'enregistrement à la source de données alors qu'un clic sur le bouton Annuler annule l'opération.

Remarque :

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 d'insertion automatique. Pour que d'autres sources de données exécutent l'opération d'insertion 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é NewText pour spécifier le texte à afficher pour un bouton Nouveau. Vous pouvez également afficher une image en affectant d'abord ButtonType.Image à la propriété ButtonType, puis en définissant la propriété NewImageUrl.

L'exemple de code suivant montre comment utiliser la propriété ShowInsertButton pour afficher un bouton Nouveau dans un contrôle DetailsView qui permet à l'utilisateur d'ajouter un nouvel enregistrement à la source de données.


<%@ 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"
            showheader="true"
            headertext="Add Customer"/>
        </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>



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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft