LinqDataSourceInsertEventArgs Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные о событии Inserting.
public ref class LinqDataSourceInsertEventArgs : System::ComponentModel::CancelEventArgs
public class LinqDataSourceInsertEventArgs : System.ComponentModel.CancelEventArgs
type LinqDataSourceInsertEventArgs = class
inherit CancelEventArgs
Public Class LinqDataSourceInsertEventArgs
Inherits CancelEventArgs
- Наследование
Примеры
В следующем примере показан обработчик события Inserting . Объект из NewObject свойства приводится к типу с именем Product. Свойство DateModifiedProduct объекта имеет текущее значение даты и времени.
protected void LinqDataSource_Inserting(object sender, LinqDataSourceInsertEventArgs e)
{
Product product = (Product)e.NewObject;
product.DateModified = DateTime.Now;
}
Protected Sub LinqDataSource_Inserting(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceInsertEventArgs)
Dim product As Product
product = CType(e.NewObject, Product)
product.DateModified = DateTime.Now
End Sub
В следующем примере показан обработчик событий для Inserting события. В нем отображаются сообщения об исключениях Label проверки с помощью элемента управления.
Protected Sub LinqDataSource_Inserting(ByVal sender As Object, _
ByVal e As LinqDataSourceInsertEventArgs)
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_Inserting(object sender,
LinqDataSourceInsertEventArgs 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;
}
}
Комментарии
Объект LinqDataSourceInsertEventArgs передается любому обработчику Inserting событий для события. Свойство NewObject содержит данные, которые будут вставлены.
Объект можно использовать LinqDataSourceInsertEventArgs для проверки данных перед выполнением операции вставки в источнике данных. Затем можно проверить данные, проверить ошибки проверки из класса данных или изменить значение перед обновлением. Можно также отменить операцию вставки.
Если объект, представляющий источник данных, создает исключение проверки перед вставкой данных, Exception свойство содержит экземпляр LinqDataSourceValidationException класса. Все исключения проверки можно получить с помощью InnerExceptions свойства. Если исключение проверки не возникаетnull, Exception свойство содержит . Если вы обрабатываете исключения проверки и не хотите, чтобы исключение было повторно создано, задайте ExceptionHandled для свойства значение true.
Конструкторы
| Имя | Описание |
|---|---|
| LinqDataSourceInsertEventArgs(LinqDataSourceValidationException) |
Инициализирует новый экземпляр LinqDataSourceInsertEventArgs класса и задает предоставленное исключение. |
| LinqDataSourceInsertEventArgs(Object) |
Инициализирует новый экземпляр класса LinqDataSourceInsertEventArgs. |
Свойства
| Имя | Описание |
|---|---|
| Cancel |
Возвращает или задает значение, указывающее, следует ли отменить событие. (Унаследовано от CancelEventArgs) |
| Exception |
Возвращает исключение, которое было создано во время проверки данных перед операцией вставки. |
| ExceptionHandled |
Возвращает или задает значение, указывающее, было ли обработано исключение и что его не следует создавать повторно. |
| NewObject |
Возвращает объект, содержащий данные для вставки. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |