OleDbCommandBuilder.GetInsertCommand メソッド

定義

名前空間:

System.Data.OleDb

アセンブリ:

System.Data.OleDb.dll

パッケージ:

System.Data.OleDb v8.0.0

データ ソースで挿入処理を実行するための、自動生成された OleDbCommand オブジェクトを取得します。

オーバーロード

GetInsertCommand()	データ ソースで挿入処理を実行するための、自動生成された OleDbCommand オブジェクトを取得します。
GetInsertCommand(Boolean)	データ ソースで挿入処理を実行するための、自動生成された OleDbCommand オブジェクトを取得します。

注釈

アプリケーションは、実行するオブジェクトの GetInsertCommand テキストを返すので、情報またはトラブルシューティングの目的で メソッドを OleDbCommand 使用できます。

変更されたコマンドの基礎として を使用 GetInsertCommand することもできます。 たとえば、 を呼び出 GetInsertCommand して値を CommandTimeout 変更し、それを に明示的に OleDbDataAdapter設定できます。

SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetInsertCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetInsertCommandをUpdateCommand呼び出すときに最初に生成されます。

GetInsertCommand()

ソース:

OleDbCommandBuilder.cs

データ ソースで挿入処理を実行するための、自動生成された OleDbCommand オブジェクトを取得します。

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand();

public System.Data.OleDb.OleDbCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand () As OleDbCommand

戻り値

OleDbCommand

挿入を実行するための自動生成された OleDbCommand オブジェクト。

注釈

アプリケーションは、実行するオブジェクトの GetInsertCommand テキストを返すので、情報またはトラブルシューティングの目的で メソッドを OleDbCommand 使用できます。

変更されたコマンドの基礎として を使用 GetInsertCommand することもできます。 たとえば、 を呼び出 GetInsertCommand して値を CommandTimeout 変更し、それを に明示的に OleDbDataAdapter設定できます。

SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetInsertCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetInsertCommandをUpdateCommand呼び出すときに最初に生成されます。

こちらもご覧ください

• CommandBuilder でのコマンドの生成

GetInsertCommand(Boolean)

ソース:

OleDbCommandBuilder.cs

データ ソースで挿入処理を実行するための、自動生成された OleDbCommand オブジェクトを取得します。

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.OleDb.OleDbCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

パラメーター

useColumnsForParameterNames

Boolean

true の場合は、可能であれば、列名に一致するパラメーターを生成します。 false の場合、@p1、@p2 のように生成します。

戻り値

OleDbCommand

挿入を実行するための自動生成された OleDbCommand オブジェクト。

注釈

アプリケーションは、実行するオブジェクトの GetInsertCommand テキストを返すので、情報またはトラブルシューティングの目的で メソッドを OleDbCommand 使用できます。

変更されたコマンドの基礎として を使用 GetInsertCommand することもできます。 たとえば、 を呼び出 GetInsertCommand して値を CommandTimeout 変更し、それを に明示的に OleDbDataAdapter設定できます。

SQL ステートメントが最初に生成された後、何らかの方法でステートメントが変更された場合、アプリケーションは明示的に を呼び出す RefreshSchema 必要があります。 それ以外の GetInsertCommand 場合、 は前のステートメントの情報を引き続き使用します。これは正しくない可能性があります。 SQL ステートメントは、アプリケーションが または GetInsertCommandをUpdateCommand呼び出すときに最初に生成されます。

パラメーター名を生成するときの既定の動作は、さまざまなパラメーターに 対して 、@p2、 などを使用@p1することです。 パラメーターをuseColumnsForParameterNames渡trueすと、 を強制OleDbCommandBuilderして列名に基づいてパラメーターを生成できます。 これは、次の条件が満たされた場合にのみ成功します。

• ParameterNameMaxLengthが指定されており、その長さが生成されたパラメーター名以上です。

• 生成されたパラメーター名は、正規表現で指定された条件を ParameterNamePattern 満たしています。

• が ParameterMarkerFormat 指定されています。

こちらもご覧ください

• CommandBuilder でのコマンドの生成