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

Aplica-se a