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. オブジェクトのプロパティは、現在の日付と時刻に設定されます。 DateModified ProductThe 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場合、 nullプロパティにはが格納されます。If 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)

適用対象