Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
DetailsViewModeEventArgs, classe
Collapse the table of content
Expand the table of content

DetailsViewModeEventArgs, classe

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

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

public class DetailsViewModeEventArgs : CancelEventArgs
public class DetailsViewModeEventArgs extends CancelEventArgs
public class DetailsViewModeEventArgs extends CancelEventArgs
Non applicable.

L'événement ModeChanging est déclenché lorsqu'un contrôle DetailsView tente de basculer entre les modes édition, insertion et lecture seule, mais avant que le mode ne change réellement. Cela vous permet de fournir un gestionnaire d'événements qui exécute une routine personnalisée, par exemple la configuration du contrôle DetailsView pour un mode spécifique ou l'annulation du changement de mode, lorsque cet événement se produit.

Un objet DetailsViewModeEventArgs est passé au gestionnaire d'événements qui vous permet de déterminer le mode vers lequel le contrôle DetailsView bascule, pour déterminer si l'événement ModeChanging a été déclenché à la suite de l'annulation par l'utilisateur d'une opération de modification ou pour indiquer qu'une opération d'insertion doit être annulée. Pour déterminer le nouveau mode, utilisez la propriété NewMode. Vous pouvez également utiliser la propriété NewMode pour basculer vers un autre mode en lui affectant l'une des valeurs d'énumération DetailsViewMode. Utilisez la propriété CancelingEdit pour déterminer si l'utilisateur a annulé une opération de modification. Pour annuler une opération d'insertion, affectez true à la propriété Cancel.

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 DetailsViewModeEventArgs, consultez le constructeur DetailsViewModeEventArgs.

L'exemple de code suivant montre comment utiliser l'objet DetailsViewModeEventArgs passé au gestionnaire d'événements pour l'événement ModeChanging afin de masquer la ligne de pagineur lorsque le contrôle DetailsView bascule en mode édition.


<%@ 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_ModeChanging(Object sender, DetailsViewModeEventArgs e)
  {

    // Use the NewMode property to determine the mode to which the 
    // DetailsView control is transitioning.
    switch (e.NewMode)
    {
      case DetailsViewMode.Edit:
        // Hide the pager row and clear the Label control
        // when transitioning to edit mode.
        CustomerDetailsView.AllowPaging = false;
        MessageLabel.Text = "";
        break;
      case DetailsViewMode.ReadOnly:
        // Display the pager row and confirmation message
        // when transitioning to edit mode.
        CustomerDetailsView.AllowPaging = true;
        if (e.CancelingEdit)
        {
          MessageLabel.Text = "Update canceled.";
        }
        else
        {
          MessageLabel.Text = "Update completed.";
        }
        break;
      case DetailsViewMode.Insert:
        // Cancel the mode change if the DetailsView
        // control attempts to transition to insert 
        // mode.
        e.Cancel = true;
        break;
      default:
        MessageLabel.Text = "Unsupported mode.";
        break;
    }
    
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsViewModeEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>DetailsViewModeEventArgs Example</h3>
                
      <asp:detailsview id="CustomerDetailsView"
        datasourceid="DetailsViewSource"
        datakeynames="CustomerID"
        autogeneraterows="true"
        autogenerateeditbutton="true" 
        allowpaging="true"
        onmodechanging="CustomerDetailsView_ModeChanging" 
        runat="server">

      </asp:detailsview>
      
      <br/><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.DetailsViewModeEventArgs

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 Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 est pris en charge sur Windows Vista, Microsoft Windows XP SP2 et Windows Server 2003 SP1.

.NET Framework

Prise en charge dans : 3.0, 2.0

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft