Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
DetailsViewModeEventArgs, classe
Fournit des données pour l'événement ModeChanging.
System.EventArgs
System.ComponentModel.CancelEventArgs
System.Web.UI.WebControls.DetailsViewModeEventArgs
Assembly : System.Web (dans System.Web.dll)
Le type DetailsViewModeEventArgs expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
DetailsViewModeEventArgs | Initialise une nouvelle instance de la classe DetailsViewModeEventArgs. |
| Nom | Description | |
|---|---|---|
|
Cancel | Obtient ou définit une valeur indiquant si l'événement doit être annulé. (Hérité de CancelEventArgs.) |
|
|
CancelingEdit | Obtient une valeur indiquant si l'événement ModeChanging a été déclenché suite à l'annulation par l'utilisateur d'une opération de modification. |
|
|
NewMode | Obtient ou définit le mode vers lequel le contrôle DetailsView bascule. |
| Nom | Description | |
|---|---|---|
|
|
Equals(Object) | Détermine si l'Object spécifié est égal à l'Object en cours. (Hérité de Object.) |
|
Finalize | Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de netto***ge avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.) |
|
|
GetHashCode | Sert de fonction de hachage pour un type particulier. (Hérité de Object.) |
|
|
GetType | Obtient le Type de l'instance actuelle. (Hérité de Object.) |
|
|
MemberwiseClone | Crée une copie superficielle de l'objet Object actif. (Hérité de Object.) |
|
|
ToString | Retourne une chaîne qui représente l'objet actuel. (Hérité de Object.) |
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 d'événements, consultez Consommation d'événements.
Pour obtenir la liste des valeurs initiales des propriétés 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>
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
