ListView.ItemCommand Événement

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 lorsqu’un bouton d’un ListView contrôle est cliqué.

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 dans le 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 des fonctionnalités intégrées du contrôle. Le tableau suivant répertorie les valeurs que vous pouvez utiliser avec la CommandName propriété d’un bouton pour appeler des fonctionnalités intégrées.

Valeur CommandName	Description
« Annuler »	Annule une opération de modification ou d’insertion. Déclenche l’événement ItemCanceling.
« Supprimer »	Supprime l’enregistrement actif de la source de données. Déclenche les événements et ItemDeleting les ItemDeleted événements.
« Sélectionner »	Définit la SelectedIndex propriété sur la DisplayIndex valeur de propriété de l’élément. Affiche le SelectedItemTemplate modèle de l’élément. Déclenche les événements et SelectedIndexChanged les SelectedIndexChanging événements.
« 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 événements et ItemInserted les ItemInserting événements.
« Mettre à jour »	Met à jour l’enregistrement actif dans la source de données avec les valeurs liées du EditItemTemplate modèle. Déclenche les événements et ItemUpdated les ItemUpdating événements.
« Trier »	Trie les colonnes répertoriées dans la `CommandArgument` propriété du bouton. Déclenche les événements et Sorted les Sorting événements.

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 la table. L’événement ItemCommand est généralement utilisé pour gérer les opérations personnalisées.

Un ListViewCommandEventArgs objet est transmis au gestionnaire d’événements, ce qui vous permet de déterminer le nom de la commande et l’argument de commande du bouton qui a été 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 gestion des événements, consultez Gestion et déclenchement d’événements.

S’applique à

Voir aussi

Commentaires

Cette page a-t-elle été utile ?