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 de os valores serem inseridos, atualizados ou excluídos por um controle LinqDataSource.

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 qualquer mensagem 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 , Deletinge Inserting . Se uma exceção de validação for gerada, a Exception propriedade do LinqDataSourceUpdateEventArgsobjeto , LinqDataSourceDeleteEventArgsou LinqDataSourceInsertEventArgs conterá 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 , Deletingou Inserting . No manipulador de eventos, marcar se a Exception propriedade da classe de argumento event 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

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 classe LinqDataSourceValidationException com dados serializados.
LinqDataSourceValidationException(String)	Inicializa uma nova instância da classe LinqDataSourceValidationException com uma mensagem especificada que descreve o erro.
LinqDataSourceValidationException(String, Exception)	Inicializa uma nova instância da classe LinqDataSourceValidationException com uma mensagem de erro especificada e uma referência à exceção interna.
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.

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. (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 que é atribuído a uma exceção específica. (Herdado de Exception)
InnerException	Obtém a instância Exception que causou a exceção atual. (Herdado de Exception)
InnerExceptions	Obtém uma ou mais exceções que ocorreram ao validar dados novos ou modificados.
Message	Obtém uma mensagem que descreve a exceção atual. (Herdado de Exception)
Source	Obtém ou define o nome do aplicativo ou objeto que causa o erro. (Herdado de Exception)
StackTrace	Obtém uma representação de cadeia de caracteres de quadros imediatos na pilha de chamadas. (Herdado de Exception)
TargetSite	Obtém o método que gerou a exceção atual. (Herdado de Exception)

Métodos

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 que é a 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 adiciona-as ao objeto SerializationInfo.
GetType()	Obtém o tipo de runtime da instância atual. (Herdado de Exception)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Cria e retorna uma representação de cadeia de caracteres da exceção atual. (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. (Herdado de Exception)