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

DetailsViewPageEventArgs classe

 

Date de publication : novembre 2016

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

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

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

public class DetailsViewPageEventArgs : CancelEventArgs

NomDescription
System_CAPS_pubmethodDetailsViewPageEventArgs(Int32)

Initialise une nouvelle instance de la classe DetailsViewPageEventArgs.

NomDescription
System_CAPS_pubpropertyCancel

Obtient ou définit une valeur indiquant si l’événement doit être annulé.(Hérité de CancelEventArgs.)

System_CAPS_pubpropertyNewPageIndex

Obtient ou définit l’index de la nouvelle page à afficher dans la DetailsView contrôle.

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.)

The T:System.Web.UI.WebControls.DetailsView control raises the E:System.Web.UI.WebControls.DetailsView.PageIndexChanging event when a pager button (a button with its CommandName property set to "Page") within the control is clicked, but before the T:System.Web.UI.WebControls.DetailsView control handles the paging operation. This allows you to provide an event handler that performs a custom routine, such as canceling the paging operation, whenever this event occurs.

System_CAPS_noteRemarque

Pager buttons are usually located in the pager row of a T:System.Web.UI.WebControls.DetailsView control.

A T:System.Web.UI.WebControls.DetailsViewPageEventArgs object is passed to the event handler, which allows you to determine the index of the page selected by the user and to indicate whether the paging operation should be canceled. To determine the index of the page selected by the user, use the P:System.Web.UI.WebControls.DetailsViewPageEventArgs.NewPageIndex property. To cancel the paging operation, set the P:System.ComponentModel.CancelEventArgs.Cancel property of the T:System.Web.UI.WebControls.DetailsViewPageEventArgs object to true.

For more information about handling events, see NIB: Consuming Events.

For a list of initial property values for an instance of the T:System.Web.UI.WebControls.DetailsViewPageEventArgs class, see the M:System.Web.UI.WebControls.DetailsViewPageEventArgs.#ctor(System.Int32) constructor.

The following code example demonstrates how to use the T:System.Web.UI.WebControls.DetailsViewPageEventArgs object passed to the event handler for the E:System.Web.UI.WebControls.DetailsView.PageIndexChanging event to cancel a paging operation when the user attempts to navigate to another page while the T:System.Web.UI.WebControls.DetailsView control is in edit mode.


<%@ 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">

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

  <head runat="server">
    <title>DetailsViewPageEventArgs Example</title>
</head>
<body>
    <form id="form1" 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>

.NET Framework
Disponible depuis 2.0

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: