LinqDataSourceValidationException Klasse

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Beschreibt eine Ausnahme, die während der Validierung neuer oder geänderter Werte aufgetreten ist, bevor die Werte durch ein LinqDataSource-Steuerelement eingefügt, aktualisiert oder gelöscht werden.

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

Vererbung

Object

Exception

LinqDataSourceValidationException

Attribute

SerializableAttribute

Implementiert

ISerializable IDynamicValidatorException

Beispiele

Das folgende Beispiel zeigt einen Ereignishandler für das Updating Ereignis. Es werden alle Validierungs-Ausnahmemeldungen mithilfe eines -Steuerelements Label angezeigt.

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

Hinweise

Die LinqDataSourceValidationException -Klasse enthält Typkonvertierungs- und Eigenschaftensetterausnahmen. Alle Ausnahmen, die während der Überprüfung ausgelöst werden, sind in der InnerExceptions Auflistung enthalten. Sie können jede Validierungs-Ausnahme abrufen, indem Sie die InnerExceptions Auflistung durchlaufen.

In der Regel behandeln Sie Ausnahmen in den UpdatingEreignissen , Deletingund Inserting . Wenn eine Validierungs-Ausnahme ausgelöst wird, enthält die Exception -Eigenschaft des LinqDataSourceUpdateEventArgs- LinqDataSourceDeleteEventArgsoder LinqDataSourceInsertEventArgs -Objekts ein LinqDataSourceValidationException -Objekt. Wenn keine Ausnahme ausgelöst wird, enthält nulldie Exception -Eigenschaft .

Um Validierungsausnahmen zu behandeln, erstellen Sie einen Handler für das Updating- oder DeletingInserting -Ereignis. Überprüfen Sie im Ereignishandler, ob die Exception Eigenschaft der Ereignisargumentklasse einen anderen Wert als nullenthält. Wenn die Exception Eigenschaft nicht NULL ist, wurden mindestens eine Validierungsausnahme ausgelöst, und Sie können jede Validierungsausnahme in der InnerExceptions -Eigenschaft abrufen.

Eine Validierungsausnahme kann auftreten, wenn ein Wert nicht mit dem Typ der Eigenschaft übereinstimmt. Wenn Sie beispielsweise versuchen, eine ganzzahlige Eigenschaft mithilfe von nicht numerischen Zeichen zu aktualisieren, wird eine Validierungsausnahmeregelung ausgelöst. Eine LINQ to SQL-Klasse kann auch benutzerdefinierte Validierungskriterien enthalten, die sicherstellen, dass die Eigenschaft einen Wert enthält, der sich innerhalb eines erwarteten Bereichs oder Musters befindet.

Konstruktoren

LinqDataSourceValidationException()	Initialisiert eine neue Instanz der LinqDataSourceValidationException-Klasse mit einer vom System bereitgestellten Meldung, in der der Fehler beschrieben wird.
LinqDataSourceValidationException(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der LinqDataSourceValidationException-Klasse mit serialisierten Daten.
LinqDataSourceValidationException(String)	Initialisiert eine neue Instanz der LinqDataSourceValidationException-Klasse mit einer angegebenen Meldung, in der der Fehler beschrieben wird.
LinqDataSourceValidationException(String, Exception)	Initialisiert eine neue Instanz der LinqDataSourceValidationException-Klasse mit der angegebenen Fehlermeldung und einem Verweis auf die innere Ausnahme.
LinqDataSourceValidationException(String, IDictionary<String,Exception>)	Initialisiert eine neue Instanz der LinqDataSourceValidationException-Klasse mit einer angegebenen Meldung, in der der Fehler beschrieben wird, sowie einer Auflistung von Verweisen auf innere Ausnahmen.

Eigenschaften

Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
HelpLink	Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Geerbt von Exception)
HResult	Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Geerbt von Exception)
InnerException	Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
InnerExceptions	Ruft eine oder mehrere Ausnahmen ab, die beim Überprüfen von neuen oder geänderten Daten aufgetreten sind.
Message	Ruft eine Meldung ab, mit der die aktuelle Ausnahme beschrieben wird. (Geerbt von Exception)
Source	Gibt den Namen der Anwendung oder des Objekts zurück, die bzw. das den Fehler verursacht hat, oder legt diesen fest. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetBaseException()	Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die Grundursache für eine oder mehrere nachfolgende Ausnahmen ist. (Geerbt von Exception)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Ruft Informationen zu der Ausnahme ab und fügt sie dem SerializationInfo-Objekt hinzu.
GetType()	Ruft den Laufzeittyp der aktuellen Instanz ab. (Geerbt von Exception)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Erstellt eine Zeichenfolgendarstellung der aktuellen Ausnahme und gibt diese zurück. (Geerbt von Exception)

Ereignisse

SerializeObjectState

Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmezustandsobjekt mit serialisierten Daten über die Ausnahme zu erstellen. (Geerbt von Exception)