LinqDataSourceValidationException Klasa

Definicja

Opisuje wyjątek, który wystąpił podczas weryfikacji wartości nowych lub zmodyfikowanych, zanim wartości zostaną wstawione, zaktualizowane lub usunięte przez LinqDataSource formant.Describes an exception that occurred during validation of new or modified values before values are inserted, updated, or deleted by a LinqDataSource control.

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
Dziedziczenie
LinqDataSourceValidationException
Atrybuty
Implementuje

Przykłady

Poniższy przykład pokazuje procedurę obsługi zdarzeń dla Updating zdarzenia.The following example shows an event handler for the Updating event. Wyświetla wszystkie komunikaty o wyjątkach weryfikacji przy użyciu Label kontrolki.It displays any validation exception messages by using a Label control.

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

Uwagi

LinqDataSourceValidationExceptionKlasa zawiera wyjątki konwersji typu i metody ustawiającej właściwość.The LinqDataSourceValidationException class contains type conversion and property setter exceptions. Wszystkie wyjątki, które są zgłaszane podczas walidacji, znajdują się w InnerExceptions kolekcji.All of the exceptions that are thrown during validation are contained in the InnerExceptions collection. Każdy wyjątek weryfikacji można pobrać poprzez iterację InnerExceptions kolekcji.You can retrieve each validation exception by iterating through the InnerExceptions collection.

Zazwyczaj obsługiwane są wyjątki w Updating Deleting zdarzeniach, i Inserting .You typically handle exceptions in the Updating, Deleting, and Inserting events. Jeśli wystąpi wyjątek walidacji, Exception Właściwość LinqDataSourceUpdateEventArgs LinqDataSourceDeleteEventArgs obiektu, lub LinqDataSourceInsertEventArgs zawiera LinqDataSourceValidationException obiekt.If a validation exception is thrown, the Exception property of the LinqDataSourceUpdateEventArgs, LinqDataSourceDeleteEventArgs, or LinqDataSourceInsertEventArgs object contains a LinqDataSourceValidationException object. Jeśli żaden wyjątek nie zostanie zgłoszony, Exception Właściwość zawiera null .If no exception is thrown, the Exception property contains null.

Aby obsłużyć wyjątki walidacji, Utwórz procedurę obsługi dla Updating Deleting zdarzenia, lub Inserting .To handle validation exceptions, create a handler for the Updating, Deleting, or Inserting event. W programie obsługi zdarzeń Sprawdź, czy Exception Właściwość klasy argument zdarzenia zawiera wartość inną niż null .In the event handler, check whether the Exception property of the event argument class contains a value other than null. Jeśli Exception Właściwość nie ma wartości null, zgłoszono co najmniej jeden wyjątek walidacji i można pobrać wszystkie wyjątki walidacji we InnerExceptions właściwości.If the Exception property is not null, one or more validation exceptions were thrown and you can retrieve each validation exception in the InnerExceptions property.

Jeśli wartość nie jest zgodna z typem właściwości, może wystąpić wyjątek walidacji.A validation exception can occur if a value does not match the type of the property. Na przykład próba zaktualizowania właściwości Integer przy użyciu znaków nienumerycznych powoduje wyjątek sprawdzania poprawności.For example, trying to update an integer property by using non-numeric characters causes a validation exception. Klasa LINQ to SQL może również zawierać niestandardowe kryteria weryfikacji, które upewnij się, że właściwość zawiera wartość znajdującą się w oczekiwanym zakresie lub wzorcu.A LINQ to SQL class can also contain customized validation criteria that make sure that the property contains a value that is within an expected range or pattern.

Konstruktory

LinqDataSourceValidationException()

Inicjuje nowe wystąpienie LinqDataSourceValidationException klasy z komunikatem dostarczonym przez system, który opisuje błąd.Initializes a new instance of the LinqDataSourceValidationException class with a system-supplied message that describes the error.

LinqDataSourceValidationException(SerializationInfo, StreamingContext)

Inicjuje nowe wystąpienie klasy LinqDataSourceValidationException z zserializowanymi danymi.Initializes a new instance of the LinqDataSourceValidationException class with serialized data.

LinqDataSourceValidationException(String)

Inicjuje nowe wystąpienie LinqDataSourceValidationException klasy z określonym komunikatem opisującym błąd.Initializes a new instance of the LinqDataSourceValidationException class with a specified message that describes the error.

LinqDataSourceValidationException(String, Exception)

Inicjuje nowe wystąpienie LinqDataSourceValidationException klasy z określonym komunikatem o błędzie i odwołaniem do wewnętrznego wyjątku.Initializes a new instance of the LinqDataSourceValidationException class with a specified error message and a reference to the inner exception.

LinqDataSourceValidationException(String, IDictionary<String,Exception>)

Inicjuje nowe wystąpienie LinqDataSourceValidationException klasy z określonym komunikatem opisującym błąd i kolekcją odwołań do wyjątków wewnętrznych.Initializes a new instance of the LinqDataSourceValidationException class with a specified message that describes the error, and a collection of references to inner exceptions.

Właściwości

Data

Pobiera kolekcję par klucz/wartość, które zawierają dodatkowe informacje zdefiniowane przez użytkownika dotyczące wyjątku.Gets a collection of key/value pairs that provide additional user-defined information about the exception.

(Odziedziczone po Exception)
HelpLink

Pobiera lub ustawia link do pliku pomocy skojarzonego z tym wyjątkiem.Gets or sets a link to the help file associated with this exception.

(Odziedziczone po Exception)
HResult

Pobiera lub ustawia wartość HRESULT, kodowane wartości liczbowe przypisane do określonego wyjątku.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception.

(Odziedziczone po Exception)
InnerException

Pobiera Exception wystąpienie, które spowodowało bieżący wyjątek.Gets the Exception instance that caused the current exception.

(Odziedziczone po Exception)
InnerExceptions

Pobiera jeden lub więcej wyjątków, które wystąpiły, gdy zostały zweryfikowane nowe lub zmodyfikowane dane.Gets one or more exceptions that occurred when new or modified data was being validated.

Message

Pobiera komunikat, który opisuje bieżący wyjątek.Gets a message that describes the current exception.

(Odziedziczone po Exception)
Source

Pobiera lub ustawia nazwę aplikacji lub obiekt, który powoduje błąd.Gets or sets the name of the application or the object that causes the error.

(Odziedziczone po Exception)
StackTrace

Pobiera ciąg reprezentujący bezpośrednie ramki w stosie wywołań.Gets a string representation of the immediate frames on the call stack.

(Odziedziczone po Exception)
TargetSite

Pobiera metodę, która zgłasza bieżący wyjątek.Gets the method that throws the current exception.

(Odziedziczone po Exception)

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetBaseException()

Gdy jest zastępowany w klasie pochodnej, zwraca wartość Exception będącą główną przyczyną jednego lub kilku kolejnych wyjątków.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions.

(Odziedziczone po Exception)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)

Pobiera informacje o wyjątku i dodaje go do SerializationInfo obiektu.Gets information about the exception and adds it to the SerializationInfo object.

GetType()

Pobiera typ środowiska uruchomieniowego bieżącego wystąpienia.Gets the runtime type of the current instance.

(Odziedziczone po Exception)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Tworzy i zwraca reprezentację ciągu bieżącego wyjątku.Creates and returns a string representation of the current exception.

(Odziedziczone po Exception)

Zdarzenia

SerializeObjectState

Występuje, gdy wyjątek jest serializowany w celu utworzenia obiektu stanu wyjątku, który zawiera serializowane dane dotyczące wyjątku.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception.

(Odziedziczone po Exception)

Dotyczy