LinqDataSourceValidationException Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Descreve uma exceção que ocorreu durante a validação de valores novos ou modificados antes de os valores serem inseridos, atualizados ou eliminados por um LinqDataSource controlo.
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 seguinte mostra um gestor de eventos para o Updating evento. Apresenta quaisquer mensagens de exceção de validação usando um Label controlo.
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;
}
}
Observações
A LinqDataSourceValidationException classe contém exceções para conversão de tipos e para o setter de propriedades. Todas as exceções lançadas durante a validação estão contidas na InnerExceptions coleção. Pode recuperar cada exceção de validação iterando pela InnerExceptions coleção.
Normalmente tratas das exceções nos Updatingeventos , Deleting, e Inserting . Se for lançada uma exceção de validação, a Exception propriedade do LinqDataSourceUpdateEventArgs, LinqDataSourceDeleteEventArgs, ou LinqDataSourceInsertEventArgs do objeto contém um LinqDataSourceValidationException objeto. Se não for lançada nenhuma exceção, a Exception propriedade contém null.
Para tratar exceções de validação, cria-se um handler para o Updating, Deleting, ou Inserting evento. No tratador de eventos, verifique se a Exception propriedade da classe de argumento de evento contém um valor diferente de null. Se a Exception propriedade não for nula, uma ou mais exceções de validação foram lançadas e pode recuperar cada exceção de validação na InnerExceptions propriedade.
Pode ocorrer uma exceção de validação se um valor não corresponder ao tipo da propriedade. Por exemplo, tentar atualizar uma propriedade inteira usando caracteres não numéricos causa uma exceção de validação. Uma classe LINQ para SQL pode também conter critérios de validação personalizados que garantem que a propriedade contém um valor dentro de um intervalo ou padrão esperado.
Construtores
| Name | Description |
|---|---|
| LinqDataSourceValidationException() |
Inicializa uma nova instância da LinqDataSourceValidationException classe com uma mensagem fornecida pelo sistema que descreve o erro. |
| LinqDataSourceValidationException(SerializationInfo, StreamingContext) |
Inicializa uma nova instância da LinqDataSourceValidationException classe com dados serializados. |
| LinqDataSourceValidationException(String, Exception) |
Inicializa uma nova instância da LinqDataSourceValidationException classe com uma mensagem de erro especificada e uma referência à exceção interna. |
| LinqDataSourceValidationException(String, IDictionary<String,Exception>) |
Inicializa uma nova instância da LinqDataSourceValidationException classe com uma mensagem especificada que descreve o erro e uma coleção de referências a exceções internas. |
| LinqDataSourceValidationException(String) |
Inicializa uma nova instância da LinqDataSourceValidationException classe com uma mensagem especificada que descreve o erro. |
Propriedades
| Name | Description |
|---|---|
| Data |
Obtém uma coleção de pares chave/valor que fornecem informação adicional definida pelo utilizador sobre a exceção. (Herdado de Exception) |
| HelpLink |
Obtém ou define um link para o ficheiro de ajuda associado a esta exceção. (Herdado de Exception) |
| HResult |
Recebe ou define HRESULT, um valor numérico codificado atribuído a uma exceção específica. (Herdado de Exception) |
| InnerException |
Obtém a Exception instância que causou a exceção atual. (Herdado de Exception) |
| InnerExceptions |
Recebe uma ou mais exceções que ocorreram quando dados novos ou modificados estavam a ser validados. |
| Message |
Recebe uma mensagem que descreve a exceção atual. (Herdado de Exception) |
| Source |
Obtém ou define o nome do aplicativo ou o objeto que causa o erro. (Herdado de Exception) |
| StackTrace |
Obtém uma representação string dos frames imediatos na stack de chamadas. (Herdado de Exception) |
| TargetSite |
Obtém o método que lança a exceção atual. (Herdado de Exception) |
Métodos
| Name | Description |
|---|---|
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetBaseException() |
Quando sobrescrito numa classe derivada, devolve o Exception que é a causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetObjectData(SerializationInfo, StreamingContext) |
Obtém informação sobre a exceção e adiciona-a ao SerializationInfo objeto. |
| GetType() |
Obtém o tipo de execução da instância atual. (Herdado de Exception) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| ToString() |
Cria e devolve uma representação string da exceção atual. (Herdado de Exception) |
evento
| Name | Description |
|---|---|
| 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. (Herdado de Exception) |