ObjectDataSource.Insert メソッド

定義

InsertMethod プロパティと InsertParameters コレクション内のパラメーターで識別されるメソッドを呼び出して挿入操作を実行します。Performs an insert operation by calling the method that is identified by the InsertMethod property and any parameters in the InsertParameters collection.

public:
 int Insert();
public int Insert ();
member this.Insert : unit -> int
Public Function Insert () As Integer

戻り値

基になるデータ ストレージに挿入する行数を表す値。A value that represents the number of rows inserted into the underlying data storage.

注釈

操作が実行OnInsertingされる前に、メソッドが呼び出されてInsertingイベントが発生します。 InsertBefore the Insert operation is performed, the OnInserting method is called to raise the Inserting event. Insertingイベントを処理して、パラメーターの値を調べたり、 Insert操作の前に前処理を実行したりすることができます。You can handle the Inserting event to examine the values of the parameters and to perform any preprocessing before an Insert operation. 挿入操作を実行するためにObjectDataSourceView 、オブジェクトはリフレクションを使用しTypeNameて、プロパティによって識別されるオブジェクトのインスタンスを作成します。To perform an insert operation, the ObjectDataSourceView object uses reflection to create an instance of the object that is identified by the TypeName property. 次に、関連付けられているInsertMethod InsertParametersプロパティを使用して、プロパティによって識別されるメソッドを呼び出します。It then calls the method that is identified by the InsertMethod property, using any associated InsertParameters properties. 操作が完了するとOnInserted 、メソッドが呼び出されてイベントInsertedが発生します。 InsertAfter the Insert operation completes, the OnInserted method is called to raise the Inserted event. Insertedイベントを処理して、戻り値、出力パラメーター、および例外を確認したり、後処理を実行したりすることができます。You can handle the Inserted event to examine any return values, output parameters, and exceptions, and to perform any post-processing.

メソッドInsertObjectDataSourceView 、コントロールObjectDataSourceInsert関連付けられているのメソッドにデリゲートします。The Insert method delegates to the Insert method of the ObjectDataSourceView that is associated with the ObjectDataSource control.

パラメーターのマージ、オブジェクトの有効期間、およびメソッドの解決の詳細InsertMethodについては、「」を参照してください。For more information about parameter merging, object lifetime, and method resolution, see InsertMethod.

データバインドコントロールData-Bound Controls

オブジェクトがGridViewコントロールなどのデータバインドコントロールに関連付けられている場合、ページコードからInsertメソッドを呼び出す必要はありません。 ObjectDataSourceWhen the ObjectDataSource object is associated with a data-bound control, such as the GridView control, it is not necessary to call the Insert method from page code. 代わりにInsert 、データバインドコントロールによってメソッドが直接呼び出されます。The Insert method is invoked directly by the data-bound control instead.

適用対象

こちらもご覧ください