LinqDataSource.Inserting LinqDataSource.Inserting LinqDataSource.Inserting LinqDataSource.Inserting Event

정의

삽입 작업 전에 발생합니다.Occurs before an insert operation.

public:
 event EventHandler<System::Web::UI::WebControls::LinqDataSourceInsertEventArgs ^> ^ Inserting;
public event EventHandler<System.Web.UI.WebControls.LinqDataSourceInsertEventArgs> Inserting;
member this.Inserting : EventHandler<System.Web.UI.WebControls.LinqDataSourceInsertEventArgs> 
Public Custom Event Inserting As EventHandler(Of LinqDataSourceInsertEventArgs) 

예제

다음 예제에서는 이벤트 처리기는 Inserting 삽입 작업 전에 데이터를 수정 하는 이벤트입니다.The following example shows an event handler for the Inserting event that modifies data before the insert operation. 개체를 NewObject 속성은 명명 된 형식으로 캐스팅 됩니다 Product합니다.The object from the NewObject property is cast to a type named Product. DateModified 의 속성을 Product 개체가 현재 날짜 및 시간으로 설정 된 합니다.The 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 that retrieves validation exceptions.

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

앞의 예제는 유효성 검사 예외를 검색합니다.The previous example retrieves validation exceptions. 값 속성의 형식과 일치 하지 않는 경우 예외가 throw 될 수 있습니다.An exception might be thrown if a value does not match the type of the property. 다음 예제에서와 같은 사용자 지정된 검사에서 throw 수도 수 있습니다.It might also be thrown from a customized check such as the one in the following example. OnAgeChanging 메서드를 확인 하는 대 한 숫자는 Age 속성이 음수입니다.The OnAgeChanging method checks that the number for the Age property is not negative.

partial void  OnAgeChanging(int? value)  
{  
    if (value < 0)  
    {  
        throw new Exception("Age cannot be a negative number.");  
    }  
}  
Private Sub OnAgeChanging(ByVal value As System.Nullable(Of Integer))  
    If (value < 0) Then  
        Throw New Exception("Age cannot be a negative number.")  
    End If  
End Sub  

설명

처리는 Inserting 삽입할, 삽입 작업 전에 값을 변경 하려면 또는 삽입 작업을 취소 하는 데이터 클래스에서 데이터 유효성 검사 오류를 검사 하는 개체의 유효성을 검사 하는 이벤트입니다.Handle the Inserting event to validate the object to be inserted, to examine data validation errors from the data class, to change a value before the insert operation, or to cancel the insert operation. LinqDataSourceInsertEventArgs 개체 데이터 소스에 삽입할 새 개체를 포함 하는이 이벤트에 대 한 이벤트 처리기에 전달 합니다.The LinqDataSourceInsertEventArgs object passed to event handlers for this event contains the new object to insert in the data source.

삽입 작업 중에 유효성 검사 오류가 발생할 경우를 LinqDataSourceInsertEventArgs 데이터 클래스에 의해 throw 되는 유효성 검사 예외를 포함 하는 개체입니다.If a validation error occurs during the insert operation, the LinqDataSourceInsertEventArgs object contains the validation exceptions that are thrown by the data class. 유효성 검사 오류를 삽입할 값 데이터 클래스의 속성 형식과 일치 하지 않는 경우 또는 사용자 지정 유효성 검사를 통과 하지 못하는 경우 발생 합니다.A validation error occurs if a value to be inserted does not match the type of the property in the data class, or if it does not pass a custom validation check. 에 대 한 이벤트 처리기는 Inserting 이벤트 유효성 검사 예외를 검색 하 고 적절 한 조치를 취할 수 있습니다.In an event handler for the Inserting event, you can retrieve the validation exceptions and take appropriate action.

에 대 한 이벤트 처리기에서 예외가 발생 하는 경우는 Inserting 이벤트를 이벤트 처리기에서 예외를 처리 해야 합니다.If an exception is thrown in an event handler for the Inserting event, you must handle the exception in that event handler. 예외에 대 한 이벤트 처리기에 전달 되지 것입니다는 Inserted 이벤트 (통해를 Exception 의 속성을 LinqDataSourceStatusEventArgs 개체).The exception will not be passed to an event handler for the Inserted event (through the Exception property of the LinqDataSourceStatusEventArgs object). 합니다 Exception 속성 뒤에 throw 되는 예외를 포함 합니다 Inserting 이벤트입니다.The Exception property contains only the exceptions that are thrown after the Inserting event.

적용 대상