LinqDataSourceStatusEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные для событий ContextCreated, Deleted, Inserted, Selected и Updated.
public ref class LinqDataSourceStatusEventArgs : EventArgs
public class LinqDataSourceStatusEventArgs : EventArgs
type LinqDataSourceStatusEventArgs = class
inherit EventArgs
Public Class LinqDataSourceStatusEventArgs
Inherits EventArgs
- Наследование
Примеры
В следующем примере показан обработчик событий для Inserted события . В обработчике событий, если Exception свойство имеет значение null
, идентификатор продукта извлекается из объекта в свойстве Result . Идентификатор продукта является первичным ключом для таблицы и задается базой данных, поэтому значение неизвестно до завершения операции вставки. Сообщение об исключении регистрируется, Exception если свойство не равно null
. Затем ExceptionHandled свойству присваивается значение 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
Комментарии
Класс LinqDataSourceStatusEventArgs позволяет изучить результаты операций с данными, выполненных элементом LinqDataSource управления. Объект LinqDataSourceStatusEventArgs передается обработчикам событий для ContextCreatedсобытий LinqDataSource , Deleted, Inserted, Selectedи Updated элемента управления .
Если операция с данными успешно завершена, результирующий объект данных сохраняется в свойстве ResultException , а свойство имеет значение null
. Если операция с данными завершилась сбоем, исключение, возниквшее во время операции с данными, сохраняется в свойстве ExceptionResult , а свойство имеет значение null
. Если вы обработали исключение, представленное свойством Exception , присвойте свойству ExceptionHandled значение true
, чтобы исключение не создавалось.
Общее количество записей данных, возвращаемых запросом, извлекается с помощью TotalRowCount свойства .
Конструкторы
LinqDataSourceStatusEventArgs(Exception) |
Инициализирует новый экземпляр класса LinqDataSourceStatusEventArgs, используя исключение, произошедшее в результате операции с данными. |
LinqDataSourceStatusEventArgs(Object) |
Инициализирует новый экземпляр класса LinqDataSourceStatusEventArgs, используя объект, содержащий данные из операции с данными. |
LinqDataSourceStatusEventArgs(Object, Int32) |
Инициализирует новый экземпляр класса LinqDataSourceStatusEventArgs, используя объект, содержащий данные из операции с данными, и количество возвращенных строк. |
Свойства
Exception |
Возвращает исключение, инициированное во время операции с данными. |
ExceptionHandled |
Возвращает или задает значение, позволяющее определить, было ли обработано исключение и должно ли оно выбрасываться снова. |
Result |
Возвращает объект, который предоставляет результат операции с данными. |
TotalRowCount |
Возвращает общее число строк в наборе данных, полученном в результате операции по извлечению данных. |
Методы
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |