LinqDataSourceValidationException Classe

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Descreve uma exceção que ocorreu durante a validação de valores novos ou modificados antes que os valores sejam inseridos, atualizados ou excluídos por um LinqDataSource controle.

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

Object

Exception

LinqDataSourceValidationException

Atributos

SerializableAttribute

Implementações

ISerializable IDynamicValidatorException

Exemplos

O exemplo a seguir mostra um manipulador de eventos para o Updating evento. Ele exibe mensagens de exceção de validação usando um Label controle.

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 exceções de conversão de tipo e setter de propriedade. Todas as exceções geradas durante a validação estão contidas na InnerExceptions coleção. Você pode recuperar cada exceção de validação iterando por meio da InnerExceptions coleção.

Normalmente, você lida com exceções nos Updatingeventos e Inserting nos Deletingeventos. Se uma exceção de validação for gerada, a Exception propriedade do LinqDataSourceUpdateEventArgsobjeto ou LinqDataSourceInsertEventArgs do objeto LinqDataSourceDeleteEventArgsconterá um LinqDataSourceValidationException objeto. Se nenhuma exceção for gerada, a Exception propriedade conterá null.

Para lidar com exceções de validação, crie um manipulador para o Updatingevento ou Inserting o . Deleting No manipulador 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 geradas e você poderá recuperar cada exceção de validação na InnerExceptions propriedade.

Uma exceção de validação poderá ocorrer se um valor não corresponder ao tipo da propriedade. Por exemplo, tentar atualizar uma propriedade de inteiro usando caracteres não numéricos causa uma exceção de validação. Uma classe LINQ to SQL também pode conter critérios de validação personalizados que garantem que a propriedade contenha um valor dentro de um intervalo ou padrão esperado.

Construtores

Nome	Description
LinqDataSourceValidationException()	Inicializa uma nova instância da classe LinqDataSourceValidationException 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 classe LinqDataSourceValidationException com uma mensagem especificada que descreve o erro.

Propriedades

Nome	Description
Data	Obtém uma coleção de pares chave/valor que fornecem informações adicionais definidas pelo usuário sobre a exceção. (Herdado de Exception)
HelpLink	Obtém ou define um link para o arquivo de ajuda associado a essa exceção. (Herdado de Exception)
HResult	Obtém 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	Obtém uma ou mais exceções que ocorreram quando dados novos ou modificados estavam sendo validados.
Message	Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception)
Source	Obtém ou define o nome do aplicativo ou do objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres dos quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gera a exceção atual. (Herdado de Exception)

Métodos

Nome	Description
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaseException()	Quando substituído em uma classe derivada, retorna a Exception causa raiz de uma ou mais exceções subsequentes. (Herdado de Exception)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Obtém informações sobre a exceção e a adiciona ao SerializationInfo objeto.
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial da atual Object. (Herdado de Object)
ToString()	Cria e retorna uma representação de cadeia de caracteres da exceção atual. (Herdado de Exception)

Eventos

Nome	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)