SqlCommandBuilder.GetInsertCommand メソッド

ソース:

System.Data.SqlClient.notsupported.cs

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();

public System.Data.SqlClient.SqlCommand GetInsertCommand();

member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand () As SqlCommand

返品

挿入を実行するために必要な自動的に生成された SqlCommand オブジェクト。

注釈

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

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

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

詳細については、「CommandBuilder でのコマンドの生成」を参照してください。

こちらもご覧ください

• ADO.NET でのデータの接続と取得
• .NET Framework Data Provider for SQL Server の使用
• ADO.NET の概要

ソース:

System.Data.SqlClient.notsupported.cs

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetInsertCommand(bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

パラメーター

返品

挿入を実行するために必要な、自動的に生成された SqlCommand オブジェクト。

注釈

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

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

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

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

• ParameterNameMaxLength メソッドの呼び出しから返され、 コレクションで見つかったDataSourceInformationが指定されており、その長さが生成されたパラメーター名以上です。

• 生成されたパラメーター名は、ParameterNamePattern メソッド呼び出しから返され、 コレクション正規表現で見つかったDataSourceInformationで指定された条件を満たしています。

• ParameterMarkerFormat メソッドの呼び出しから返され、 コレクションで見つかったDataSourceInformationが指定されています。

詳細については、「CommandBuilder でのコマンドの生成」を参照してください。

こちらもご覧ください

• ADO.NET でのデータの接続と取得
• .NET Framework Data Provider for SQL Server の使用
• ADO.NET の概要