LinqDataSourceValidationException Klasse

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Beschreibt eine Ausnahme, die bei der Überprüfung neuer oder geänderter Werte aufgetreten ist, bevor Werte von einem 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 zeigt alle Gültigkeitsprüfungs-Ausnahmemeldungen mithilfe eines Label Steuerelements an.

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 Eigenschaftssatzer-Ausnahmen. Alle Ausnahmen, die während der Überprüfung ausgelöst werden, sind in der InnerExceptions Auflistung enthalten. Sie können jede Überprüfungs exception abrufen, indem Sie die InnerExceptions Sammlung durchlaufen.

In der Regel behandeln Sie Ausnahmen in den Updating, Deletingund Inserting Ereignissen. Wenn eine Gültigkeitsprüfungs 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 .

Erstellen Sie zum Behandeln von Überprüfungs exceptions einen Handler für das Updating, Deletingoder Inserting das Ereignis. Überprüfen Sie im Ereignishandler, ob die Exception Eigenschaft der Ereignisargumentklasse einen anderen Wert als null. Wenn die Exception Eigenschaft nicht NULL ist, wurden mindestens eine Gültigkeitsprüfungs exceptions ausgelöst, und Sie können jede Gültigkeitsprüfungs ausnahme in der InnerExceptions Eigenschaft abrufen.

Eine Gültigkeitsprüfungs exception can occur if a value does not match the type of the property. Wenn Sie z. B. versuchen, eine ganzzahlige Eigenschaft mithilfe von nicht numerischen Zeichen zu aktualisieren, wird eine Gültigkeitsprüfungs ausnahme ausgelöst. Eine LINQ to SQL-Klasse kann auch angepasste Überprüfungskriterien enthalten, die sicherstellen, dass die Eigenschaft einen Wert enthält, der sich innerhalb eines erwarteten Bereichs oder Musters befindet.

Konstruktoren

Name	Beschreibung
LinqDataSourceValidationException()	Initialisiert eine neue Instanz der LinqDataSourceValidationException Klasse mit einer vom System bereitgestellten Meldung, die den Fehler beschreibt.
LinqDataSourceValidationException(SerializationInfo, StreamingContext)	Initialisiert eine neue Instanz der LinqDataSourceValidationException Klasse mit serialisierten Daten.
LinqDataSourceValidationException(String, Exception)	Initialisiert eine neue Instanz der LinqDataSourceValidationException Klasse mit einer 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, die den Fehler beschreibt, und eine Sammlung von Verweisen auf innere Ausnahmen.
LinqDataSourceValidationException(String)	Initialisiert eine neue Instanz der LinqDataSourceValidationException Klasse mit einer angegebenen Meldung, die den Fehler beschreibt.

Eigenschaften

Name	Beschreibung
Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zur Ausnahme bereitstellen. (Geerbt von Exception)
HelpLink	Dient zum Abrufen oder Festlegen eines Links zur Hilfedatei, die dieser Ausnahme zugeordnet ist. (Geerbt von Exception)
HResult	Dient zum Abrufen oder Festlegen von HRESULT, einem codierten numerischen Wert, der einer bestimmten Ausnahme zugewiesen ist. (Geerbt von Exception)
InnerException	Ruft die Exception Instanz ab, die die aktuelle Ausnahme verursacht hat. (Geerbt von Exception)
InnerExceptions	Ruft mindestens eine Ausnahme ab, die aufgetreten ist, wenn neue oder geänderte Daten überprüft wurden.
Message	Ruft eine Nachricht ab, die die aktuelle Ausnahme beschreibt. (Geerbt von Exception)
Source	Dient zum Abrufen oder Festlegen des Namens der Anwendung oder des Objekts, das den Fehler verursacht. (Geerbt von Exception)
StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames im Aufrufstapel ab. (Geerbt von Exception)
TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Geerbt von Exception)

Methoden

Name	Beschreibung
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetBaseException()	Wenn sie in einer abgeleiteten Klasse überschrieben wird, wird die Exception Ursache einer oder mehrerer nachfolgenden Ausnahmen zurückgegeben. (Geerbt von Exception)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Ruft Informationen über die 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 der aktuellen Object. (Geerbt von Object)
ToString()	Erstellt und gibt eine Zeichenfolgendarstellung der aktuellen Ausnahme zurück. (Geerbt von Exception)

Ereignisse

Name	Beschreibung
SerializeObjectState	Tritt auf, wenn eine Ausnahme serialisiert wird, um ein Ausnahmestatusobjekt zu erstellen, das serialisierte Daten zu der Ausnahme enthält. (Geerbt von Exception)