DetailsViewPageEventArgs, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

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

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

public class DetailsViewPageEventArgs : CancelEventArgs
public class DetailsViewPageEventArgs extends CancelEventArgs
public class DetailsViewPageEventArgs extends CancelEventArgs

Le contrôle DetailsView déclenche l'événement PageIndexChanging suite à un clic sur le bouton du pagineur (bouton dont la propriété CommandName a la valeur "Page"), mais avant que le contrôle DetailsView ne gère l'opération de pagination. Cela vous permet de fournir un gestionnaire d'événements qui exécute une routine personnalisée, par exemple l'annulation de l'opération de pagination, lorsque cet événement se produit.

RemarqueRemarque

Les boutons du pagineur se trouvent habituellement sur la ligne du pagineur d'un contrôle DetailsView.

Un objet DetailsViewPageEventArgs est passé à la méthode de gestion d'événements, ce qui vous permet de déterminer l'index de la page sélectionnée par l'utilisateur et d'indiquer si l'opération de pagination doit être annulée. Pour déterminer l'index de la page sélectionnée par l'utilisateur, utilisez la propriété NewPageIndex. Pour annuler l'opération de pagination, affectez true à la propriété Cancel de l'objet DetailsViewPageEventArgs.

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

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

L'exemple de code suivant montre comment utiliser l'objet DetailsViewPageEventArgs passé au gestionnaire d'événements pour l'événement PageIndexChanging afin d'annuler une opération de pagination lorsque l'utilisateur essaie d'accéder à une autre page alors que le contrôle DetailsView est en mode édition.


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

<script runat="server">
  
  void CustomerDetailsView_PageIndexChanging(Object sender, DetailsViewPageEventArgs e)
  {
    // Cancel the paging operation if the DetailsView control 
    // in edit mode.
    if (CustomerDetailsView.CurrentMode == DetailsViewMode.Edit)
    {
      e.Cancel = true;
      
      // Display an error message.
      int newPage = e.NewPageIndex + 1;
      MessageLabel.Text = "Please update the current record before to moving to page " + 
        newPage.ToString() + ".";
    }
  }

  void CustomerDetailsView_ModeChanging(Object sender, DetailsViewModeEventArgs e)
  {
    // Clear the message label when the user cancels edit mode.
    if (e.CancelingEdit)
    {
      MessageLabel.Text = "";
    }
  }
  
</script>

<html>

  <body>
    <form runat="server">
        
      <h3>DetailsViewPageEventArgs Example</h3>
                       
        <asp:detailsview id="CustomerDetailsView"
          datasourceid="DetailsViewSource"
          autogeneraterows="true"
          autogenerateeditbutton="true"
          datakeynames="CustomerID"  
          allowpaging="true"
          onpageindexchanging="CustomerDetailsView_PageIndexChanging" 
          onmodechanging="CustomerDetailsView_ModeChanging"
          runat="server">
            
          <pagersettings position="Bottom"/> 
                    
        </asp:detailsview>
        
        <br/>
        
        <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
            
        <!-- 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="DetailsViewSource"
          selectcommand="Select [CustomerID], [CompanyName], [Address], 
            [City], [PostalCode], [Country] From [Customers]"
          updatecommand="Update [Customers] Set 
          [CompanyName]=@CompanyName, [Address]=@Address, 
          [City]=@City, [PostalCode]=@PostalCode, 
          [Country]=@Country 
          Where [CustomerID]=@CustomerID"
          connectionstring=
          "<%$ ConnectionStrings:NorthWindConnectionString%>" 
          runat="server"/>
            
      </form>
  </body>
</html>


  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
  • AspNetHostingPermission  pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal

System.Object
   System.EventArgs
     System.ComponentModel.CancelEventArgs
      System.Web.UI.WebControls.DetailsViewPageEventArgs

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

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

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

.NET Framework

Prise en charge dans : 2.0

Ajouts de la communauté

AJOUTER
Afficher: