ListView.ItemCommand Événement

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.Extensions.dll

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.

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

public:
 event EventHandler<System::Web::UI::WebControls::ListViewCommandEventArgs ^> ^ ItemCommand;

public event EventHandler<System.Web.UI.WebControls.ListViewCommandEventArgs> ItemCommand;

member this.ItemCommand : EventHandler<System.Web.UI.WebControls.ListViewCommandEventArgs>

Public Custom Event ItemCommand As EventHandler(Of ListViewCommandEventArgs)

Type d'événement

EventHandler<ListViewCommandEventArgs>

Exemples

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>

<%@ Page language="VB" %>

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

<script runat="server">
  Protected Sub EmployeesListView_OnItemCommand(ByVal sender As Object, _
  ByVal e As ListViewCommandEventArgs)
    
    If String.Equals(e.CommandName, "AddToList") Then
      
      ' Verify that the employee ID is not already in the list. If not, add the
      ' employee to the list.
      Dim dataItem As ListViewDataItem = CType(e.Item, ListViewDataItem)
      Dim employeeID As String = _
        EmployeesListView.DataKeys(dataItem.DisplayIndex).Value.ToString()
      
      If SelectedEmployeesListBox.Items.FindByValue(employeeID) Is Nothing Then
        Dim item As ListItem = _
          New ListItem(e.CommandArgument.ToString(), employeeID)
        SelectedEmployeesListBox.Items.Add(item)
      End If
      
    End If
    
  End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head2" 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>

Remarques

L’événement ItemCommand est déclenché lorsqu’un bouton du ListView contrôle est cliqué. Cela vous permet d’effectuer une routine personnalisée chaque fois que cet événement se produit.

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

Valeur CommandName	Description
« Annuler »	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 ItemDeleted événements et ItemDeleting .
« Sélectionner »	Définit la SelectedIndex propriété sur la valeur de la DisplayIndex propriété pour l’élément. Affiche le SelectedItemTemplate modèle de l’élément. Déclenche les SelectedIndexChanging événements et SelectedIndexChanged .
« Modifier »	Place l’élément en mode édition. Affiche le EditItemTemplate modèle de l’élément. Déclenche l’événement ItemEditing.
« Insérer »	Insère les valeurs liées du InsertItemTemplate modèle dans la source de données. Déclenche les ItemInserting événements et ItemInserted .
« Mise à jour »	Mises à jour l’enregistrement actif dans la source de données avec les valeurs liées du EditItemTemplate modèle. Déclenche les ItemUpdating événements et ItemUpdated .
« Trier »	Trie les colonnes répertoriées dans la `CommandArgument` propriété du bouton. Déclenche les Sorting événements et Sorted .

L’événement ItemCommand est également déclenché lorsqu’un bouton répertorié dans le tableau précédent est cliqué. Toutefois, il est recommandé d’utiliser les événements répertoriés dans le tableau. L’événement ItemCommand est généralement utilisé pour gérer des opérations personnalisées.

Un ListViewCommandEventArgs objet 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é. Pour déterminer le nom de la commande, utilisez la CommandEventArgs.CommandName propriété . Pour déterminer l’argument de commande, utilisez la CommandEventArgs.CommandArgument propriété . Pour accéder au contrôle qui a déclenché l’événement, utilisez la ListViewCommandEventArgs.CommandSource propriété .

Pour plus d’informations sur la façon de gérer les événements, consultez gestion et déclenchement d’événements.

S’applique à

ListView.ItemCommand Événement

Définition

Type d'événement

Exemples

Remarques

S’applique à

Voir aussi

Commentaires

Ressources supplémentaires