LinqDataSourceInsertEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données pour l'événement Inserting.
public ref class LinqDataSourceInsertEventArgs : System::ComponentModel::CancelEventArgs
public class LinqDataSourceInsertEventArgs : System.ComponentModel.CancelEventArgs
type LinqDataSourceInsertEventArgs = class
inherit CancelEventArgs
Public Class LinqDataSourceInsertEventArgs
Inherits CancelEventArgs
- Héritage
Exemples
L’exemple suivant montre un gestionnaire pour l’événement Inserting . L’objet de la NewObject propriété est converti en un type nommé Product
. La DateModified
propriété de l’objet Product
est définie sur la date et l’heure actuelles.
protected void LinqDataSource_Inserting(object sender, LinqDataSourceInsertEventArgs e)
{
Product product = (Product)e.NewObject;
product.DateModified = DateTime.Now;
}
Protected Sub LinqDataSource_Inserting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceInsertEventArgs)
Dim product As Product
product = CType(e.NewObject, Product)
product.DateModified = DateTime.Now
End Sub
L’exemple suivant montre un gestionnaire d’événements pour l’événement Inserting . Il affiche les messages d’exception de validation à l’aide d’un Label contrôle .
Protected Sub LinqDataSource_Inserting(ByVal sender As Object, _
ByVal e As LinqDataSourceInsertEventArgs)
If (e.Exception IsNot Nothing) Then
For Each innerException As KeyValuePair(Of String, Exception) _
In e.Exception.InnerExceptions
Label1.Text &= innerException.Key & ": " & _
innerException.Value.Message + "<br />"
Next
e.ExceptionHandled = True
End If
End Sub
protected void LinqDataSource_Inserting(object sender,
LinqDataSourceInsertEventArgs e)
{
if (e.Exception != null)
{
foreach (KeyValuePair<string, Exception> innerException in
e.Exception.InnerExceptions)
{
Label1.Text += innerException.Key + ": " +
innerException.Value.Message + "<br />";
}
e.ExceptionHandled = true;
}
}
Remarques
L’objet LinqDataSourceInsertEventArgs est passé à n’importe quel gestionnaire d’événements pour l’événement Inserting . La NewObject propriété contient les données qui seront insérées.
Vous pouvez utiliser l’objet LinqDataSourceInsertEventArgs pour examiner les données avant l’exécution de l’opération d’insertion dans la source de données. Vous pouvez ensuite valider les données, examiner les erreurs de validation de la classe de données ou modifier une valeur avant la mise à jour. Vous pouvez également annuler l’opération d’insertion.
Si l’objet qui représente la source de données lève une exception de validation avant d’insérer les données, la Exception propriété contient un instance de la LinqDataSourceValidationException classe . Vous pouvez récupérer toutes les exceptions de validation via la InnerExceptions propriété . Si aucune exception de validation n’est levée, la Exception propriété contient null
. Si vous gérez les exceptions de validation et que vous ne souhaitez pas que l’exception soit levée à nouveau, définissez la propriété sur ExceptionHandledtrue
.
Constructeurs
LinqDataSourceInsertEventArgs(LinqDataSourceValidationException) |
Initialise une nouvelle instance de la classe LinqDataSourceInsertEventArgs et spécifie l'exception fournie. |
LinqDataSourceInsertEventArgs(Object) |
Initialise une nouvelle instance de la classe LinqDataSourceInsertEventArgs. |
Propriétés
Cancel |
Obtient ou définit une valeur indiquant si l'événement doit être annulé. (Hérité de CancelEventArgs) |
Exception |
Obtient l'exception levée lors de la validation des données avant l'opération d'insertion. |
ExceptionHandled |
Obtient ou définit une valeur qui indique si l'exception a été gérée et qu'elle ne doit plus être levée. |
NewObject |
Obtient l'objet qui contient les données à insérer. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |