LinqDataSourceStatusEventArgs Classe

Definição

Fornece dados para os ContextCreated, Deleted, Inserted, Selected, e Updated eventos.

public ref class LinqDataSourceStatusEventArgs : EventArgs
public class LinqDataSourceStatusEventArgs : EventArgs
type LinqDataSourceStatusEventArgs = class
    inherit EventArgs
Public Class LinqDataSourceStatusEventArgs
Inherits EventArgs
Herança
LinqDataSourceStatusEventArgs

Exemplos

O exemplo seguinte mostra um gestor de eventos para o Inserted evento. No gestor de eventos, se a Exception propriedade for null, o ID do produto é recuperado do objeto na Result propriedade. O ID do produto é uma chave primária para a tabela e é definido pela base de dados, pelo que o valor não é conhecido até que a operação de inserção tenha terminado. A mensagem de exceção é registada se a Exception propriedade não for igual a null. A ExceptionHandled propriedade é então definida para true.

protected void LinqDataSource_Inserted(object sender, LinqDataSourceStatusEventArgs e)
{
    if (e.Exception == null)
    {
        Product newProduct = (Product)e.Result;
        Literal1.Text = "The new product id is " + newProduct.ProductID;
        Literal1.Visible = true;            
    }
    else
    {
        LogError(e.Exception.Message);
        Literal1.Text = "We are sorry. There was a problem saving the record. The administrator has been notified.";
        Literal1.Visible = true;
        e.ExceptionHandled = true;            
    }
}
Protected Sub LinqDataSource_Inserted(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceStatusEventArgs)
    If (IsNothing(e.Exception)) Then
        Dim newProduct As Product
        newProduct = CType(e.Result, Product)
        Literal1.Text = "The new product id is " & newProduct.ProductID
        Literal1.Visible = True
    Else
        LogError(e.Exception.Message)
        Literal1.Text = "We are sorry. There was a problem saving the record. The administrator has been notified."
        Literal1.Visible = True
        e.ExceptionHandled = True
    End If
End Sub

Observações

A LinqDataSourceStatusEventArgs classe permite-lhe analisar os resultados das operações de dados realizadas por um LinqDataSource controlo. Um objeto é passado aos gestores LinqDataSourceStatusEventArgs de eventos para os ContextCreated, Deleted, Inserted, Selected, e Updated eventos do LinqDataSource controlo.

Se a operação de dados for concluída com sucesso, o objeto de dados resultante é armazenado na Result propriedade e a Exception propriedade é null. Se a operação de dados falhou, a exceção que ocorreu durante a operação de dados é armazenada na Exception propriedade e a Result propriedade é null. Se manuseou a exceção representada pela Exception propriedade, defina a ExceptionHandled propriedade para true que a exceção não seja lançada.

Recupera o número total de registos de dados devolvidos de uma consulta através da TotalRowCount propriedade.

Construtores

Name Description
LinqDataSourceStatusEventArgs(Exception)

Inicializa uma nova instância da LinqDataSourceStatusEventArgs classe usando uma exceção que ocorreu como resultado da operação de dados.

LinqDataSourceStatusEventArgs(Object, Int32)

Inicializa uma nova instância da LinqDataSourceStatusEventArgs classe com um objeto que contém os dados da operação de dados e o número de linhas devolvidas.

LinqDataSourceStatusEventArgs(Object)

Inicializa uma nova instância da LinqDataSourceStatusEventArgs classe usando um objeto que contenha os dados da operação de dados.

Propriedades

Name Description
Exception

Recebe a exceção que foi lançada durante a operação de dados.

ExceptionHandled

Recebe ou define um valor que indica se a exceção foi tratada e que não deve ser lançada novamente.

Result

Obtém o objeto que representa o resultado de uma operação de dados.

TotalRowCount

Obtém o número total de linhas num conjunto de dados a partir de uma operação de recuperação de dados.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a