LinqDataSourceValidationException Classe

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Descrive un'eccezione verificatasi durante la convalida di valori nuovi o modificati prima che essi vengano inseriti, aggiornati o eliminati da un controllo 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

Ereditarietà

Object

Exception

LinqDataSourceValidationException

Attributi

SerializableAttribute

Implementazioni

ISerializable IDynamicValidatorException

Esempio

Nell'esempio seguente viene illustrato un gestore eventi per l'evento Updating . Visualizza tutti i messaggi di eccezione di convalida usando un Label controllo .

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;  
    }  
}  

Commenti

La LinqDataSourceValidationException classe contiene eccezioni di conversione dei tipi e setter di proprietà. Tutte le eccezioni generate durante la InnerExceptions convalida sono contenute nella raccolta. È possibile recuperare ogni eccezione di convalida eseguendo l'iterazione della InnerExceptions raccolta.

In genere si gestiscono le eccezioni negli Updatingeventi , Deletinge Inserting . Se viene generata un'eccezione di convalida, la Exception proprietà dell'oggetto LinqDataSourceUpdateEventArgs, LinqDataSourceDeleteEventArgso LinqDataSourceInsertEventArgs contiene un LinqDataSourceValidationException oggetto . Se non viene generata alcuna eccezione, la Exception proprietà contiene null.

Per gestire le eccezioni di convalida, creare un gestore per l'evento Updating, Deletingo Inserting . Nel gestore eventi verificare se la Exception proprietà della classe dell'argomento evento contiene un valore diverso da null. Se la Exception proprietà non è Null, sono state generate una o più eccezioni di convalida ed è possibile recuperare ogni eccezione di convalida nella InnerExceptions proprietà .

Un'eccezione di convalida può verificarsi se un valore non corrisponde al tipo della proprietà. Ad esempio, se si tenta di aggiornare una proprietà integer usando caratteri non numerici, viene generata un'eccezione di convalida. Una classe LINQ to SQL può contenere anche criteri di convalida personalizzati che assicurano che la proprietà contenga un valore compreso in un intervallo o un criterio previsto.

Costruttori

LinqDataSourceValidationException()	Inizializza una nuova istanza della classe LinqDataSourceValidationException con un messaggio di sistema che descrive l'errore.
LinqDataSourceValidationException(SerializationInfo, StreamingContext)	Inizializza una nuova istanza della classe LinqDataSourceValidationException con dati serializzati.
LinqDataSourceValidationException(String)	Inizializza una nuova istanza della classe LinqDataSourceValidationException con un messaggio specificato che descrive l'errore.
LinqDataSourceValidationException(String, Exception)	Inizializza una nuova istanza della classe LinqDataSourceValidationException con un riferimento all'eccezione interna e un messaggio di errore specificati.
LinqDataSourceValidationException(String, IDictionary<String,Exception>)	Inizializza una nuova istanza della classe LinqDataSourceValidationException con un messaggio specificato che descrive l'errore e un insieme di riferimenti a eccezioni interne.

Proprietà

Data	Ottiene una raccolta di coppie chiave/valore che forniscono informazioni definite dall'utente aggiuntive sull'eccezione. (Ereditato da Exception)
HelpLink	Ottiene o imposta un collegamento al file della Guida associato all'eccezione. (Ereditato da Exception)
HResult	Ottiene o imposta HRESULT, un valore numerico codificato che viene assegnato a un'eccezione specifica. (Ereditato da Exception)
InnerException	Ottiene l'istanza di Exception che ha causato l'eccezione corrente. (Ereditato da Exception)
InnerExceptions	Ottiene una o più eccezioni verificatesi durante la convalida di dati nuovi o modificati.
Message	Ottiene un messaggio che descrive l'eccezione corrente. (Ereditato da Exception)
Source	Ottiene o imposta il nome dell'oggetto o dell'applicazione che ha generato l'errore. (Ereditato da Exception)
StackTrace	Ottiene una rappresentazione di stringa dei frame immediati nello stack di chiamate. (Ereditato da Exception)
TargetSite	Ottiene il metodo che genera l'eccezione corrente. (Ereditato da Exception)

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetBaseException()	Quando ne viene eseguito l'override in una classe derivata, restituisce l'Exception che è la causa radice di una o più eccezioni successive. (Ereditato da Exception)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)	Ottiene informazioni sull'eccezione e le aggiunge all'oggetto SerializationInfo.
GetType()	Ottiene il tipo di runtime dell'istanza corrente. (Ereditato da Exception)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Crea e restituisce una rappresentazione di stringa dell'eccezione corrente. (Ereditato da Exception)

Eventi

SerializeObjectState

Si verifica quando un'eccezione viene serializzata per creare un oggetto di stato eccezione contenente i dati serializzati relativi all'eccezione. (Ereditato da Exception)