Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

ListView.ItemCommand, événement

Se produit lorsque l'on clique sur un bouton dans un contrôle ListView.

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

public event EventHandler<ListViewCommandEventArgs> ItemCommand
<asp:ListView OnItemCommand="EventHandler" />

L'événement ItemCommand est déclenché lorsque vous cliquez sur un bouton du contrôle ListView. Cela vous permet d'exécuter une routine personnalisée chaque fois que cet événement se produit.

Les boutons dans un contrôle ListView peuvent aussi appeler une fonctionnalité intégrée du contrôle. Le tableau suivant répertorie les valeurs que vous pouvez utiliser avec la propriété CommandName d'un bouton pour appeler la fonctionnalité intégrée.

Valeur de CommandName

Description

"Cancel"

Annule une opération de modification ou d'insertion. Déclenche l'événement ItemCanceling.

"Delete"

Supprime l'enregistrement actuel de la source de données. Déclenche les événements ItemDeleted et ItemDeleting.

"Select"

Affecte à la propriété SelectedIndex la valeur de la propriété DisplayIndex pour l'élément. Restitue le modèle SelectedItemTemplate pour l'élément. Déclenche les événements SelectedIndexChanging et SelectedIndexChanged.

"Edit"

Met l'élément en mode Édition. Restitue le modèle EditItemTemplate pour l'élément. Déclenche l'événement ItemEditing.

"Insert"

Insère les valeurs liées du modèle InsertItemTemplate dans la source de données. Déclenche les événements ItemInserting et ItemInserted.

"Update"

Met à jour l'enregistrement actif dans la source de données avec les valeurs liées du modèle EditItemTemplate. Déclenche les événements ItemUpdating et ItemUpdated.

"Sort"

Trie les colonnes répertoriées dans la propriété CommandArgument du bouton. Déclenche les événements Sorting et Sorted.

L'événement ItemCommand est également déclenché lorsque l'on clique sur un bouton répertorié dans le tableau précédent. Toutefois, il est recommandé d'utiliser les événements répertoriés dans le tableau. L'événement ItemCommand est utilisé habituellement pour gérer des opérations personnalisées.

Un objet ListViewCommandEventArgs est passé au gestionnaire d'événements ce qui vous permet de déterminer le nom de la commande et l'argument de commande du bouton sur lequel vous avez cliqué. Utilisez la propriété CommandEventArgs.CommandName pour déterminer le nom de la commande. Utilisez la propriété CommandEventArgs.CommandArgument pour déterminer l'argument de la commande. Utilisez la propriété ListViewCommandEventArgs.CommandSource pour accéder au contrôle qui a déclenché l'événement.

Pour plus d'informations sur la gestion d'événements, consultez Consommation d'événements.

L'exemple suivant montre comment créer un gestionnaire d'événements ItemCommand.


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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
  protected void EmployeesListView_OnItemCommand(object sender, ListViewCommandEventArgs e)
  {
    if (String.Equals(e.CommandName, "AddToList"))
    {
      // Verify that the employee ID is not already in the list. If not, add the
      // employee to the list.
      ListViewDataItem dataItem = (ListViewDataItem)e.Item;
      string employeeID = 
        EmployeesListView.DataKeys[dataItem.DisplayIndex].Value.ToString();

      if (SelectedEmployeesListBox.Items.FindByValue(employeeID) == null)
      {
        ListItem item = new ListItem(e.CommandArgument.ToString(), employeeID);
        SelectedEmployeesListBox.Items.Add(item);
      }
    }
  }
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>Employee List</title>
  </head>
  <body>
    <form id="form1" runat="server">
      <asp:ListView runat="server" 
        ID="EmployeesListView"
        OnItemCommand="EmployeesListView_OnItemCommand"
        DataSourceID="EmployeesDataSource" 
        DataKeyNames="EmployeeID">
        <LayoutTemplate>
          <table runat="server" id="tblEmployees" 
                 cellspacing="0" cellpadding="1" width="440px" border="1">
            <tr id="itemPlaceholder" runat="server"></tr>
          </table>
          <asp:DataPager ID="EmployeesDataPager" runat="server" PageSize="10">
            <Fields>
              <asp:NumericPagerField />
            </Fields>
          </asp:DataPager>
        </LayoutTemplate>
        <ItemTemplate>
          <tr runat="server">
            <td>
              <asp:Label runat="server" ID="NameLabel" 
                Text='<%#Eval("LastName") + ", " + Eval("FirstName") %>' />
            </td>
            <td style="width:80px">
              <asp:LinkButton runat="server" 
                ID="SelectEmployeeButton" 
                Text="Add To List" 
                CommandName="AddToList" 
                CommandArgument='<%#Eval("LastName") + ", " + Eval("FirstName") %>' />
            </td>
          </tr>
        </ItemTemplate>
      </asp:ListView>

      <br /><br />
      <b>Selected Employees:</b><br />
      <asp:ListBox runat="server" ID="SelectedEmployeesListBox" Rows="10" Width="300px" />

      <!-- This example uses Microsoft SQL Server and connects      -->
      <!-- to the AdventureWorks sample database. Use an ASP.NET    -->
      <!-- expression to retrieve the connection string value       -->
      <!-- from the Web.config file.                                -->       
      <asp:SqlDataSource ID="EmployeesDataSource" runat="server" 
        ConnectionString="<%$ ConnectionStrings:AdventureWorks_DataConnectionString %>"
        SelectCommand="SELECT [EmployeeID], [FirstName], [LastName]
                       FROM HumanResources.vEmployee
                       ORDER BY [LastName], [FirstName], [EmployeeID]">
      </asp:SqlDataSource>
    </form>
  </body>
</html>


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

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

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