LinqDataSourceValidationException Classe
Definição
Descreve uma exceção que ocorreu durante a validação de valores novos ou modificados antes de os valores serem inseridos, atualizados ou excluídos por um controle LinqDataSource.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
- Herança
- Atributos
- Implementações
Exemplos
O exemplo a seguir mostra um manipulador de eventos para o Updating evento.The following example shows an event handler for the Updating event. Ele exibe todas as mensagens de exceção de validação usando um Label controle.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;
}
}
Comentários
A LinqDataSourceValidationException classe contém as exceções de conversão de tipo e setter de propriedade.The LinqDataSourceValidationException class contains type conversion and property setter exceptions. Todas as exceções geradas durante a validação estão contidas na InnerExceptions coleção.All of the exceptions that are thrown during validation are contained in the InnerExceptions collection. Você pode recuperar cada exceção de validação Iterando pela InnerExceptions coleção.You can retrieve each validation exception by iterating through the InnerExceptions collection.
Normalmente, você lida com exceções Updating nos Deleting eventos, e Inserting .You typically handle exceptions in the Updating, Deleting, and Inserting events. Se uma exceção de validação for lançada, a Exception Propriedade do LinqDataSourceUpdateEventArgs LinqDataSourceDeleteEventArgs objeto, ou LinqDataSourceInsertEventArgs conterá um LinqDataSourceValidationException objeto.If a validation exception is thrown, the Exception property of the LinqDataSourceUpdateEventArgs, LinqDataSourceDeleteEventArgs, or LinqDataSourceInsertEventArgs object contains a LinqDataSourceValidationException object. Se nenhuma exceção for gerada, a Exception Propriedade conterá null .If no exception is thrown, the Exception property contains null.
Para lidar com exceções de validação, crie um manipulador para o Updating Deleting evento, ou Inserting .To handle validation exceptions, create a handler for the Updating, Deleting, or Inserting event. No manipulador de eventos, verifique se a Exception propriedade da classe de argumento de evento contém um valor diferente de null .In the event handler, check whether the Exception property of the event argument class contains a value other than null. Se a Exception propriedade não for nula, uma ou mais exceções de validação foram geradas e você poderá recuperar cada exceção de validação na InnerExceptions propriedade.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.
Uma exceção de validação pode ocorrer se um valor não corresponder ao tipo da propriedade.A validation exception can occur if a value does not match the type of the property. Por exemplo, tentar atualizar uma propriedade de inteiro usando caracteres não numéricos causa uma exceção de validação.For example, trying to update an integer property by using non-numeric characters causes a validation exception. Uma classe de LINQ to SQL também pode conter critérios de validação personalizados que verificam se a propriedade contém um valor que está dentro de um intervalo ou padrão esperado.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.
Construtores
| LinqDataSourceValidationException() |
Inicializa uma nova instância da classe LinqDataSourceValidationException com uma mensagem fornecida pelo sistema que descreve o erro.Initializes a new instance of the LinqDataSourceValidationException class with a system-supplied message that describes the error. |
| LinqDataSourceValidationException(SerializationInfo, StreamingContext) |
Inicializa uma nova instância da classe LinqDataSourceValidationException com dados serializados.Initializes a new instance of the LinqDataSourceValidationException class with serialized data. |
| LinqDataSourceValidationException(String) |
Inicializa uma nova instância da classe LinqDataSourceValidationException com uma mensagem especificada que descreve o erro.Initializes a new instance of the LinqDataSourceValidationException class with a specified message that describes the error. |
| LinqDataSourceValidationException(String, Exception) |
Inicializa uma nova instância da classe LinqDataSourceValidationException com uma mensagem de erro especificada e uma referência à exceção interna.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>) |
Inicializa uma nova instância da classe LinqDataSourceValidationException com uma mensagem especificada que descreve o erro e uma coleção de referências às exceções internas.Initializes a new instance of the LinqDataSourceValidationException class with a specified message that describes the error, and a collection of references to inner exceptions. |
Propriedades
| Data |
Obtém uma coleção de pares de chave/valor que fornecem informações definidas pelo usuário adicionais sobre a exceção.Gets a collection of key/value pairs that provide additional user-defined information about the exception. (Herdado de Exception) |
| HelpLink |
Obtém ou define um link para o arquivo de ajuda associado a essa exceção.Gets or sets a link to the help file associated with this exception. (Herdado de Exception) |
| HResult |
Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica.Gets or sets HRESULT, a coded numerical value that is assigned to a specific exception. (Herdado de Exception) |
| InnerException |
Obtém a instância Exception que causou a exceção atual.Gets the Exception instance that caused the current exception. (Herdado de Exception) |
| InnerExceptions |
Obtém uma ou mais exceções que ocorreram ao validar dados novos ou modificados.Gets one or more exceptions that occurred when new or modified data was being validated. |
| Message |
Obtém uma mensagem que descreve a exceção atual.Gets a message that describes the current exception. (Herdado de Exception) |
| Source |
Obtém ou define o nome do aplicativo ou objeto que causa o erro.Gets or sets the name of the application or the object that causes the error. (Herdado de Exception) |
| StackTrace |
Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas.Gets a string representation of the immediate frames on the call stack. (Herdado de Exception) |
| TargetSite |
Obtém o método que gerou a exceção atual.Gets the method that throws the current exception. (Herdado de Exception) |
Métodos
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| GetBaseException() |
Quando substituído em uma classe derivada, retorna a Exception que é a causa raiz de uma ou mais exceções subsequentes.When overridden in a derived class, returns the Exception that is the root cause of one or more subsequent exceptions. (Herdado de Exception) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Obtém informações sobre a exceção e adiciona-as ao objeto SerializationInfo.Gets information about the exception and adds it to the SerializationInfo object. |
| GetType() |
Obtém o tipo de runtime da instância atual.Gets the runtime type of the current instance. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| ToString() |
Cria e retorna uma representação de cadeia de caracteres da exceção atual.Creates and returns a string representation of the current exception. (Herdado de Exception) |
Eventos
| SerializeObjectState |
Ocorre quando uma exceção é serializada para criar um objeto de estado de exceção que contém dados serializados sobre a exceção.Occurs when an exception is serialized to create an exception state object that contains serialized data about the exception. (Herdado de Exception) |