LinqDataSourceInsertEventArgs LinqDataSourceInsertEventArgs LinqDataSourceInsertEventArgs LinqDataSourceInsertEventArgs Class

Определение

Предоставляет данные для события Inserting.Provides data for the Inserting event.

public ref class LinqDataSourceInsertEventArgs : System::ComponentModel::CancelEventArgs
public class LinqDataSourceInsertEventArgs : System.ComponentModel.CancelEventArgs
type LinqDataSourceInsertEventArgs = class
    inherit CancelEventArgs
Public Class LinqDataSourceInsertEventArgs
Inherits CancelEventArgs
Наследование
LinqDataSourceInsertEventArgsLinqDataSourceInsertEventArgsLinqDataSourceInsertEventArgsLinqDataSourceInsertEventArgs

Примеры

В следующем примере показан обработчик для Inserting события.The following example shows a handler for the Inserting event. Объект из NewObject свойства приводится к типу с именем Product.The object from the NewObject property is cast to a type named Product. СвойствуProduct объекта присваивается текущее значение даты и времени. DateModifiedThe DateModified property of the Product object is set to the current date and time.

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 события.The following example shows an event handler for the Inserting event. Он отображает все сообщения об исключениях проверки с Label помощью элемента управления.It displays any validation exception messages by using a Label control.

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;  
    }  
}  

Комментарии

Объект передается в любой обработчик событий Inserting для события. LinqDataSourceInsertEventArgsThe LinqDataSourceInsertEventArgs object is passed to any event handler for the Inserting event. NewObject Свойство содержит данные, которые будут вставлены.The NewObject property contains the data that will be inserted.

LinqDataSourceInsertEventArgs Объект можно использовать для проверки данных до выполнения операции вставки в источнике данных.You can use the LinqDataSourceInsertEventArgs object to examine the data before the insert operation is executed in the data source. Затем можно проверить данные, проверить ошибки проверки из класса данных или изменить значение до обновления.You can then validate the data, examine validation errors from the data class, or change a value before the update. Можно также отменить операцию вставки.You can also cancel the insert operation.

Если объект, представляющий источник данных, создает исключение проверки перед вставкой данных, Exception свойство содержит экземпляр LinqDataSourceValidationException класса.If the object that represents the data source throws a validation exception before it inserts the data, the Exception property contains an instance of the LinqDataSourceValidationException class. Все исключения проверки можно получить с помощью InnerExceptions свойства.You can retrieve all the validation exceptions through the InnerExceptions property. Если исключение проверки не возникает, Exception свойство содержит. nullIf no validation exception is thrown, the Exception property contains null. Если вы обрабатываете исключения проверки и не хотите, чтобы исключение создавалось повторно, присвойте ExceptionHandled trueсвойству значение.If you handle the validation exceptions and do not want the exception to be re-thrown, set the ExceptionHandled property to true.

Конструкторы

LinqDataSourceInsertEventArgs(LinqDataSourceValidationException) LinqDataSourceInsertEventArgs(LinqDataSourceValidationException) LinqDataSourceInsertEventArgs(LinqDataSourceValidationException) LinqDataSourceInsertEventArgs(LinqDataSourceValidationException)

Инициализирует новый экземпляр класса LinqDataSourceInsertEventArgs и задает предусмотренное исключение.Initializes a new instance of the LinqDataSourceInsertEventArgs class and specifies the provided exception.

LinqDataSourceInsertEventArgs(Object) LinqDataSourceInsertEventArgs(Object) LinqDataSourceInsertEventArgs(Object) LinqDataSourceInsertEventArgs(Object)

Инициализирует новый экземпляр класса LinqDataSourceInsertEventArgs.Initializes a new instance of the LinqDataSourceInsertEventArgs class.

Свойства

Cancel Cancel Cancel Cancel

Возвращает или задает значение, показывающее, следует ли отменить событие.Gets or sets a value indicating whether the event should be canceled.

(Inherited from CancelEventArgs)
Exception Exception Exception Exception

Возвращает исключение, происходящее при проверке данных перед выполнением операции вставки.Gets the exception that was thrown while the data was being validated before the insert operation.

ExceptionHandled ExceptionHandled ExceptionHandled ExceptionHandled

Возвращает или задает значение, позволяющее определить, было ли обработано исключение и должно ли оно выбрасываться снова.Gets or sets a value that indicates whether the exception was handled and that it should not be thrown again.

NewObject NewObject NewObject NewObject

Возвращает объект, содержащий данные для вставки.Gets the object that contains the data to insert.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

Применяется к