Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

ListViewCommandEventArgs classe

 

Date de publication : novembre 2016

Fournit des données pour l'événement ItemCommand.

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

System.Object
  System.EventArgs
    System.Web.UI.WebControls.CommandEventArgs
      System.Web.UI.WebControls.ListViewCommandEventArgs

public class ListViewCommandEventArgs : CommandEventArgs

NomDescription
System_CAPS_pubmethodListViewCommandEventArgs(ListViewItem, Object, CommandEventArgs)

Initialise une nouvelle instance de la ListViewCommandEventArgs classe à l’aide de la source spécifiée des commande arguments et d’événements.

NomDescription
System_CAPS_pubpropertyCommandArgument

Obtient l’argument de la commande.(Hérité de CommandEventArgs.)

System_CAPS_pubpropertyCommandName

Obtient le nom de la commande.(Hérité de CommandEventArgs.)

System_CAPS_pubpropertyCommandSource

Obtient la source de la commande.

System_CAPS_pubpropertyHandled

Obtient ou définit une valeur qui indique si le contrôle a géré l’événement.

System_CAPS_pubpropertyItem

Obtient l’élément de données pour laquelle la commande a été émise.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

Le ItemCommand événement est déclenché lorsqu’un bouton dans le ListView est activé. Cela vous permet de fournir une méthode de gestion d’événements qui exécute une routine personnalisée chaque fois que cet événement se produit.

System_CAPS_noteRemarque

Le ListView contrôle déclenche également d’autres événements lorsque l’utilisateur clique sur certains boutons (boutons, par exemple, avec le CommandName propriété la valeur « Delete », « Update » ou « Page »). Lorsque vous utilisez un de ces boutons, vous pouvez gérer un des événements spécialisés fournis par le contrôle, tel que le ItemDeleted ou ItemDeleting les événements.

Un ListViewCommandEventArgs objet est passé à la méthode de gestion d’événements, ce qui vous permet de déterminer le nom de la commande et l’argument de commande du bouton sur lequel l’utilisateur a cliqué. Pour déterminer l’utilisation de nom de commande du CommandName propriété et pour déterminer l’argument de commande, utilisez le CommandArgument propriété. Vous pouvez également accéder au contrôle bouton qui a déclenché l’événement à l’aide de la CommandSource propriété.

Pour obtenir la liste des valeurs de propriété initiales d'une instance de la classe ListViewCommandEventArgs, consultez le constructeur ListViewCommandEventArgs.

L’exemple suivant montre comment utiliser le ListViewCommandEventArgs objet qui est passé au gestionnaire d’événements.

<%@ 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
Disponible depuis 3.5

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: