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
|
DetailsViewInsertEventArgs, classe
Fournit des données pour l'événement ItemInserting.
System.EventArgs
System.ComponentModel.CancelEventArgs
System.Web.UI.WebControls.DetailsViewInsertEventArgs
Assembly : System.Web (dans System.Web.dll)
Le type DetailsViewInsertEventArgs expose les membres suivants.
| Nom | Description | |
|---|---|---|
|
DetailsViewInsertEventArgs | Initialise une nouvelle instance de la classe DetailsViewInsertEventArgs. |
| Nom | Description | |
|---|---|---|
|
Cancel | Obtient ou définit une valeur indiquant si l'événement doit être annulé. (Hérité de CancelEventArgs.) |
|
|
CommandArgument | Obtient l'argument de commande pour l'opération d'insertion passée au contrôle DetailsView. |
|
|
Values | Obtient un dictionnaire qui contient les paires nom/valeur des champs de l'enregistrement à insérer. |
| 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.) |
Le contrôle DetailsView déclenche l'événement ItemInserting lorsqu'un utilisateur clique sur un bouton Insérer (bouton dont la propriété CommandName a la valeur "Insert") situé dans le contrôle, mais avant que le contrôle DetailsView n'insère l'enregistrement. Cela vous permet de fournir un gestionnaire d'événements qui exécute une routine personnalisée, par exemple l'encodage HTML des valeurs d'un enregistrement avant l'insertion dans la source de données, chaque fois que cet événement se produit.
Un objet DetailsViewInsertEventArgs est passé au gestionnaire d'événements, ce qui vous permet de déterminer la valeur d'un argument de commande facultatif envoyé au contrôle DetailsView et d'indiquer que l'opération d'insertion doit être annulée. Pour déterminer la valeur d'un argument de commande, utilisez la propriété CommandArgument. Pour annuler l'opération d'insertion, affectez true à la propriété Cancel. Vous pouvez également lire ou modifier les valeurs de champ du nouvel enregistrement en utilisant la propriété Values.
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 DetailsViewInsertEventArgs, consultez le constructeur DetailsViewInsertEventArgs.
L'exemple de code suivant montre comment utiliser l'objet DetailsViewInsertEventArgs passé au gestionnaire d'événements pour l'événement ItemInserting afin d'annuler une opération d'insertion.
<%@ 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_ItemInserting(Object sender, DetailsViewInsertEventArgs e) { // Use the Values property to retrieve the key field value. String keyValue = e.Values["CustomerID"].ToString(); // Insert the record only if the key field is four characters // long; otherwise, cancel the insert operation. if (keyValue.Length == 4) { // Change the key field value to upper case before inserting // the record in the data source. e.Values["CustomerID"] = keyValue.ToUpper(); MessageLabel.Text = ""; } else { MessageLabel.Text = "The key field must have four digits."; e.Cancel = true; } } </script> <html xmlns="http://www.w3.org/1999/xhtml" > <head runat="server"> <title>DetailsViewInsertEventArgs Example</title> </head> <body> <form id="form1" runat="server"> <h3>DetailsViewInsertEventArgs Example</h3> <asp:detailsview id="CustomerDetailsView" datasourceid="DetailsViewSource" datakeynames="CustomerID" autogenerateinsertbutton="true" autogeneraterows="true" allowpaging="true" oniteminserting="CustomerDetailsView_ItemInserting" runat="server"> <fieldheaderstyle backcolor="Navy" forecolor="White"/> </asp:detailsview> <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]" insertcommand="INSERT INTO [Customers]([CustomerID], [CompanyName], [Address], [City], [PostalCode], [Country]) VALUES (@CustomerID, @CompanyName, @Address, @City, @PostalCode, @Country)" 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.
