LinqDataSourceStatusEventArgs 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.
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
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) |