LinqDataSourceValidationException Classe

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Décrit une exception qui s’est produite lors de la validation de valeurs nouvelles ou modifiées avant que les valeurs ne soient insérées, mises à jour ou supprimées par un LinqDataSource contrôle.

public ref class LinqDataSourceValidationException : Exception, System::Web::DynamicData::IDynamicValidatorException

[System.Serializable]
public class LinqDataSourceValidationException : Exception, System.Web.DynamicData.IDynamicValidatorException

[<System.Serializable>]
type LinqDataSourceValidationException = class
    inherit Exception
    interface IDynamicValidatorException
    interface ISerializable

Public Class LinqDataSourceValidationException
Inherits Exception
Implements IDynamicValidatorException

Héritage

Object

Exception

LinqDataSourceValidationException

Attributs

SerializableAttribute

Implémente

ISerializable IDynamicValidatorException

Exemples

L’exemple suivant montre un gestionnaire d’événements pour l’événement Updating . Il affiche les messages d’exception de validation à l’aide d’un Label contrôle.

Protected Sub LinqDataSource_Updating(ByVal sender As Object, _
        ByVal e As LinqDataSourceUpdateEventArgs)
    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_Updating(object sender,
        LinqDataSourceUpdateEventArgs 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

La LinqDataSourceValidationException classe contient des exceptions de conversion de type et de jeu de propriétés. Toutes les exceptions levées pendant la validation sont contenues dans la InnerExceptions collection. Vous pouvez récupérer chaque exception de validation en itérant dans la InnerExceptions collection.

Vous gérez généralement les exceptions dans les événements Deletinget Inserting les Updatingévénements. Si une exception de validation est levée, la Exception propriété du ou LinqDataSourceDeleteEventArgsLinqDataSourceInsertEventArgs de l’objet LinqDataSourceUpdateEventArgscontient un LinqDataSourceValidationException objet. Si aucune exception n’est levée, la Exception propriété contient null.

Pour gérer les exceptions de validation, créez un gestionnaire pour le , Deletingou Inserting l’événementUpdating. Dans le gestionnaire d’événements, vérifiez si la Exception propriété de la classe d’argument d’événement contient une valeur autre que null. Si la Exception propriété n’est pas null, une ou plusieurs exceptions de validation ont été levées et vous pouvez récupérer chaque exception de validation dans la InnerExceptions propriété.

Une exception de validation peut se produire si une valeur ne correspond pas au type de la propriété. Par exemple, la tentative de mise à jour d’une propriété entière à l’aide de caractères non numériques provoque une exception de validation. Une classe LINQ to SQL peut également contenir des critères de validation personnalisés qui vérifient que la propriété contient une valeur qui se trouve dans une plage ou un modèle attendu.

Constructeurs

Nom	Description
LinqDataSourceValidationException()	Initialise une nouvelle instance de la LinqDataSourceValidationException classe avec un message fourni par le système qui décrit l’erreur.
LinqDataSourceValidationException(SerializationInfo, StreamingContext)	Initialise une nouvelle instance de la LinqDataSourceValidationException classe avec des données sérialisées.
LinqDataSourceValidationException(String, Exception)	Initialise une nouvelle instance de la LinqDataSourceValidationException classe avec un message d’erreur spécifié et une référence à l’exception interne.
LinqDataSourceValidationException(String, IDictionary<String,Exception>)	Initialise une nouvelle instance de la LinqDataSourceValidationException classe avec un message spécifié qui décrit l’erreur et une collection de références aux exceptions internes.
LinqDataSourceValidationException(String)	Initialise une nouvelle instance de la LinqDataSourceValidationException classe avec un message spécifié qui décrit l’erreur.

Propriétés

Nom	Description
Data	Obtient une collection de paires clé/valeur qui fournissent des informations supplémentaires définies par l’utilisateur sur l’exception. (Hérité de Exception)
HelpLink	Obtient ou définit un lien vers le fichier d’aide associé à cette exception. (Hérité de Exception)
HResult	Obtient ou définit HRESULT, valeur numérique codée affectée à une exception spécifique. (Hérité de Exception)
InnerException	Obtient l’instance Exception qui a provoqué l’exception actuelle. (Hérité de Exception)
InnerExceptions	Obtient une ou plusieurs exceptions qui se sont produites lorsque des données nouvelles ou modifiées ont été validées.
Message	Obtient un message qui décrit l’exception actuelle. (Hérité de Exception)
Source	Obtient ou définit le nom de l’application ou de l’objet qui provoque l’erreur. (Hérité de Exception)
StackTrace	Obtient une représentation sous forme de chaîne des images immédiates sur la pile des appels. (Hérité de Exception)
TargetSite	Obtient la méthode qui lève l’exception actuelle. (Hérité de Exception)

Méthodes

Nom	Description
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetBaseException()	En cas de substitution dans une classe dérivée, retourne la Exception cause racine d’une ou plusieurs exceptions ultérieures. (Hérité de Exception)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)	Obtient des informations sur l’exception et l’ajoute à l’objet SerializationInfo .
GetType()	Obtient le type d’exécution de l’instance actuelle. (Hérité de Exception)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Crée et retourne une représentation sous forme de chaîne de l’exception actuelle. (Hérité de Exception)

Événements

Nom	Description
SerializeObjectState	Se produit lorsqu’une exception est sérialisée pour créer un objet d’état d’exception qui contient des données sérialisées sur l’exception. (Hérité de Exception)