LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs LinqDataSourceUpdateEventArgs Class

定義

Updating イベントにデータを提供します。Provides data for the Updating event.

public ref class LinqDataSourceUpdateEventArgs : System::ComponentModel::CancelEventArgs
public class LinqDataSourceUpdateEventArgs : System.ComponentModel.CancelEventArgs
type LinqDataSourceUpdateEventArgs = class
    inherit CancelEventArgs
Public Class LinqDataSourceUpdateEventArgs
Inherits CancelEventArgs
継承
LinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgsLinqDataSourceUpdateEventArgs

次の例は、イベント ハンドラーをUpdatingイベント。The following example shows an event handler for the Updating event. 例からのプロパティを比較する方法を示します、OriginalObjectプロパティとNewObjectを決定するプロパティかどうかの値、Categoryプロパティが変更されました。The example shows how to compare properties from the OriginalObject property and the NewObject property to determine whether the value in the Category property has changed. そうである場合、CategoryChanged内のオブジェクトのプロパティ、NewObjectプロパティに設定されてtrueします。If so, the CategoryChanged property of the object in the NewObject property is set to true.

protected void LinqDataSource_Updating(object sender, LinqDataSourceUpdateEventArgs e)
{
    Product originalProduct = (Product)e.OriginalObject;
    Product newProduct = (Product)e.NewObject;

    if (originalProduct.Category != newProduct.Category)
    {
        newProduct.CategoryChanged = true;
    }
}
Protected Sub LinqDataSource_Updating(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.LinqDataSourceUpdateEventArgs)
    Dim originalProduct As Product
    Dim newProduct As Product

    originalProduct = CType(e.OriginalObject, Product)
    newProduct = CType(e.NewObject, Product)

    If (originalProduct.Category <> newProduct.Category) Then
        newProduct.CategoryChanged = True
    End If
End Sub

次の例は、イベント ハンドラーをUpdatingイベント。The following example shows an event handler for the Updating event. 使用して検証例外メッセージが表示されます、Labelコントロール。It displays any validation exception messages by using a Label control.

Protected Sub LinqDataSource_Updating(ByVal sender As Object, _  
        ByVal e As LinqDataSourceUpdateEventArgs)  
    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_Updating(object sender,   
        LinqDataSourceUpdateEventArgs 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;  
    }  
}  

注釈

LinqDataSourceUpdateEventArgsオブジェクトは、のいずれかのイベント ハンドラーに渡される、Updatingイベント。The LinqDataSourceUpdateEventArgs object is passed to any event handler for the Updating event. 使用することができます、LinqDataSourceUpdateEventArgsをデータ ソースの更新操作が実行される前に、データを調べるオブジェクト。You can use the LinqDataSourceUpdateEventArgs object to examine the data before the update operation is executed in the data source. データの検証、データ クラスによってスローされる検証例外、または更新前に、の値を変更し、ことができます。You can then validate the data, examine validation exceptions thrown by the data class, or change a value before the update. 更新操作をキャンセルすることもできます。You can also cancel the update operation.

OriginalObjectオブジェクトには、最初に、データ ソースから取得したデータが含まれています。The OriginalObject object contains the data that was originally retrieved from the data source. NewObjectオブジェクトには、更新操作中に、データ ソースに保存されるデータが含まれています。The NewObject object contains the data that will be saved in the data source during the update operation.

データ ソースを表すオブジェクトをデータを更新する前に検証例外をスローした場合、Exceptionプロパティにはインスタンスが含まれています、LinqDataSourceValidationExceptionクラス。If the object that represents the data source throws a validation exception before updating 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.

既定で、LinqDataSourceコントロール ストアのビューで、データ ソースから、元の値があるものを除き、Web ページに状態ColumnAttribute属性がマークUpdateCheck.Neverします。By default, the LinqDataSource control stores the original values from the data source in view state on the Web page, except those whose ColumnAttribute attribute is marked as UpdateCheck.Never. LINQ to SQL は、自動的にデータを更新する前に、データの整合性をチェックします。LINQ to SQL automatically checks the integrity of the data before updating the data. これは、ビュー ステートに格納されている元の値をデータ ソースの現在の値を比較することで。It does this by comparing the current values in the data source with the original values stored in view state. LINQ to SQL では、データ ソースの値が変更された場合に例外が発生します。LINQ to SQL raises an exception if the values in the data source have changed. 追加のデータ検証を実行するには、ハンドラーを作成して、Updatingイベント。You can perform additional data validation by creating a handler for the Updating event.

コンストラクター

LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException) LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException) LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException) LinqDataSourceUpdateEventArgs(LinqDataSourceValidationException)

指定した例外を使用して、LinqDataSourceUpdateEventArgs クラスの新しいインスタンスを初期化します。Initializes a new instance of the LinqDataSourceUpdateEventArgs class with the specified exception.

LinqDataSourceUpdateEventArgs(Object, Object) LinqDataSourceUpdateEventArgs(Object, Object) LinqDataSourceUpdateEventArgs(Object, Object) LinqDataSourceUpdateEventArgs(Object, Object)

LinqDataSourceUpdateEventArgs クラスの新しいインスタンスを初期化します。Initializes a new instance of the LinqDataSourceUpdateEventArgs 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 update 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 values that will be saved in the data source.

OriginalObject OriginalObject OriginalObject OriginalObject

データ ソースから取得された元の値が格納されたオブジェクトを取得します。Gets the object that contains the values that were originally retrieved from the data source.

メソッド

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)

適用対象

こちらもご覧ください