OdbcCommand.ExecuteNonQuery メソッド
メモ : この名前空間、クラス、およびメンバは、.NET Framework Version 1.1 だけでサポートされています。
Connection に対して SQL ステートメントを実行し、影響を受けた行数を返します。
Public Overridable Function ExecuteNonQuery() As Integer Implements _ IDbCommand.ExecuteNonQuery
[C#]
public virtual int ExecuteNonQuery();
[C++]
public: virtual int ExecuteNonQuery();
[JScript]
public function ExecuteNonQuery() : int;
戻り値
UPDATE、INSERT、DELETE の各ステートメントで、戻り値はそのコマンドの影響を受ける行の数です。その他の種類のステートメントでの戻り値は、-1 です。
実装
例外
| 例外の種類 | 条件 |
|---|---|
| InvalidOperationException | 接続が存在しません。
または 接続が開いていません。 |
解説
ExecuteNonQuery を使用して、カタログ操作 (データベース構造の照会、テーブルなどのデータベース オブジェクトの作成など) を実行できます。また、UPDATE、INSERT、または DELETE の各ステートメントを実行して、 DataSet を使用せずにデータベースのデータを変更できます。
また、基になる ODBC ドライバがこの機能をサポートしている場合は、 ExecuteNonQuery を使用して複数の SQL ステートメントを実行することもできます。この場合、戻り値は、そのコマンド内のすべてのステートメントの影響を受ける行数です。
ExecuteNonQuery は行を返しませんが、出力パラメータ、またはパラメータに割り当てられた戻り値にはデータが格納されます。
UPDATE、INSERT、DELETE の各ステートメントで、戻り値はそのコマンドの影響を受ける行の数です。他の種類のステートメントでの戻り値は、-1 です。ロールバックが発生した場合も、戻り値は -1 です。
使用例
[Visual Basic, C#, C++] OdbcCommand を作成し、 ExecuteNonQuery を使用して実行する例を次に示します。この例では、SQL ステートメント (UPDATE、INSERT、DELETE など) の文字列とデータ ソースへの接続に使用する文字列が渡されます。
Public Sub CreateMyOdbcCommand(myExecuteQuery As String, _
myConnectionString As String)
Dim myConnection As New OdbcConnection(myConnectionString)
Dim myCommand As New OdbcCommand(myExecuteQuery, myConnection)
myCommand.Connection.Open()
myCommand.ExecuteNonQuery()
MyConnection.Close()
End Sub
[C#]
public void CreateMyOdbcCommand(string myExecuteQuery, string myConnectionString)
{
OdbcConnection myConnection = new OdbcConnection(myConnectionString);
OdbcCommand myCommand = new OdbcCommand(myExecuteQuery, myConnection);
myCommand.Connection.Open();
myCommand.ExecuteNonQuery();
myConnection.Close();
}
[C++]
public:
void CreateMyOdbcCommand(String* myExecuteQuery, String* myConnectionString)
{
OdbcConnection* myConnection = new OdbcConnection(myConnectionString);
OdbcCommand* myCommand = new OdbcCommand(myExecuteQuery, myConnection);
myCommand->Connection->Open();
myCommand->ExecuteNonQuery();
myConnection->Close();
};
[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン .gif)
をクリックします。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ