ObjectDataSource.Insert メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
挿入操作を実行するには、 InsertMethod プロパティで識別されるメソッドと、 InsertParameters コレクション内のパラメーターを呼び出します。
public:
int Insert();public int Insert();member this.Insert : unit -> intPublic Function Insert () As Integer戻り値
基になるデータ ストレージに挿入された行数を表す値。
注釈
Insert操作が実行される前に、OnInserting メソッドが呼び出されて、Inserting イベントが発生します。 Inserting イベントを処理して、パラメーターの値を調べ、Insert操作の前に前処理を実行できます。 挿入操作を実行するために、 ObjectDataSourceView オブジェクトはリフレクションを使用して、 TypeName プロパティによって識別されるオブジェクトのインスタンスを作成します。 次に、関連付けられているInsertParametersプロパティを使用して、InsertMethod プロパティによって識別されるメソッドを呼び出します。 Insert操作が完了すると、OnInserted メソッドが呼び出され、Inserted イベントが発生します。 Inserted イベントを処理して、戻り値、出力パラメーター、例外を調べ、後処理を実行できます。
Insert メソッドは、ObjectDataSource コントロールに関連付けられているObjectDataSourceViewのInsert メソッドにデリゲートします。
パラメーターのマージ、オブジェクトの有効期間、およびメソッドの解決の詳細については、 InsertMethodを参照してください。
Data-Bound コントロール
ObjectDataSource オブジェクトがデータ バインド コントロール (GridView コントロールなど) に関連付けられている場合、ページ コードから Insert メソッドを呼び出す必要はありません。 Insert メソッドは、代わりにデータ バインド コントロールによって直接呼び出されます。
