LinqDataSourceValidationException Classe

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

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

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 tous 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 setter 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 Updatingévénements , Deletinget Inserting . Si une exception de validation est levée, la Exception propriété de l’objet LinqDataSourceUpdateEventArgs, LinqDataSourceDeleteEventArgsou LinqDataSourceInsertEventArgs contient 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 l’événement Updating, Deletingou Inserting . Dans le gestionnaire d’événements, case activée 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 entraîne 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

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

Propriétés

Data	Obtient une collection de paires clé/valeur qui fournissent des informations définies par l'utilisateur supplémentaires 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 qui est assigné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 lors de la validation de données nouvelles ou modifiées.
Message	Obtient un message qui décrit l'exception active. (Hérité de Exception)
Source	Obtient ou définit le nom de l'application ou de l'objet qui est à l'origine de l'erreur. (Hérité de Exception)
StackTrace	Obtient une représentation sous forme de chaîne des frames immédiats 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

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 qui est à l'origine d'une ou de plusieurs exceptions ultérieures. (Hérité de Exception)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetObjectData(SerializationInfo, StreamingContext)	Obtient des informations sur l'exception et les ajoute à l'objet SerializationInfo.
GetType()	Obtient le type au moment de l'exécution de l'instance actuelle. (Hérité de Exception)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Crée et retourne une chaîne représentant l'exception actuelle. (Hérité de Exception)

Événements

SerializeObjectState

Se produit quand une exception est sérialisée pour créer un objet d'état d'exception qui contient des données sérialisées concernant l'exception. (Hérité de Exception)