OdbcCommand クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
データ ソースに対して実行する SQL ステートメントまたはストアド プロシージャを表します。 このクラスは継承できません。
public ref class OdbcCommand sealed : System::Data::Common::DbCommand, ICloneable
public ref class OdbcCommand sealed : System::ComponentModel::Component, ICloneable, IDisposable, System::Data::IDbCommand
public sealed class OdbcCommand : System.Data.Common.DbCommand, ICloneable
public sealed class OdbcCommand : System.ComponentModel.Component, ICloneable, IDisposable, System.Data.IDbCommand
type OdbcCommand = class
inherit DbCommand
interface ICloneable
type OdbcCommand = class
inherit Component
interface ICloneable
interface IDbCommand
interface IDisposable
Public NotInheritable Class OdbcCommand
Inherits DbCommand
Implements ICloneable
Public NotInheritable Class OdbcCommand
Inherits Component
Implements ICloneable, IDbCommand, IDisposable
- 継承
- 継承
- 実装
例
ExecuteNonQuery の使用例を次に示します。
public void InsertRow(string connectionString, string insertSQL)
{
using (OdbcConnection connection =
new OdbcConnection(connectionString))
{
// The insertSQL string contains a SQL statement that
// inserts a new row in the source table.
OdbcCommand command = new OdbcCommand(insertSQL, connection);
// Open the connection and execute the insert command.
try
{
connection.Open();
command.ExecuteNonQuery();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
// The connection is automatically closed when the
// code exits the using block.
}
Public Sub InsertRow(ByVal connectionString As String, _
ByVal insertSQL As String)
Using connection As New OdbcConnection(connectionString)
' The insertSQL string contains a SQL statement that
' inserts a new row in the source table.
Dim command As New OdbcCommand(insertSQL, connection)
' Open the connection and execute the insert command.
Try
connection.Open()
command.ExecuteNonQuery()
Catch ex As Exception
Console.WriteLine(ex.Message)
End Try
' The connection is automatically closed when the
' code exits the Using block.
End Using
End Sub
注釈
クラスには OdbcCommand 、データ ソースに対してコマンドを実行するための次のメソッドが用意されています。
Item | 説明 |
---|---|
ExecuteReader | 行を返すコマンドを実行します。 |
ExecuteNonQuery | SQL INSERT、DELETE、UPDATE、SET ステートメントなどのコマンドを実行します。 |
ExecuteScalar | 1 つの値 (集計値など) をデータベースから取得します。 |
プロパティを CommandText リセットし、オブジェクトを OdbcCommand 再利用できます。 ただし、新しいコマンドまたは前の OdbcDataReader コマンドを実行するには、 を閉じる必要があります。
コマンドを実行すると、重大度レベルが 20 以上のSQL Serverなどの致命的なOdbcException結果が発生した場合は、OdbcConnection閉じる可能性があります。 ただし、ユーザーは接続を再び開き、続行できます。
コンストラクター
OdbcCommand() |
OdbcCommand クラスの新しいインスタンスを初期化します。 |
OdbcCommand(String) |
クエリ テキストを指定して、OdbcCommand クラスの新しいインスタンスを初期化します。 |
OdbcCommand(String, OdbcConnection) |
クエリ テキストと OdbcCommand オブジェクトを使用して、OdbcConnection クラスの新しいインスタンスを初期化します。 |
OdbcCommand(String, OdbcConnection, OdbcTransaction) |
クエリのテキスト、OdbcConnection オブジェクト、および Transaction を指定して、OdbcCommand クラスの新しいインスタンスを初期化します。 |
プロパティ
CanRaiseEvents |
コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component) |
CommandText |
データ ソースに対して実行する SQL ステートメントまたはストアド プロシージャを取得または設定します。 |
CommandTimeout |
コマンド実行の試行を終了してエラーを生成するまでの待機時間 (秒単位) を取得または設定します。 |
CommandType |
CommandText プロパティをどのように解釈するかを示す値を取得または設定します。 |
Connection |
この OdbcCommand のインスタンスで使用する OdbcConnection を取得または設定します。 |
Container |
IContainer を含む Component を取得します。 (継承元 Component) |
DbConnection |
この DbConnection により使用される DbCommand を取得または設定します。 (継承元 DbCommand) |
DbParameterCollection |
DbParameter オブジェクトのコレクションを取得します。 (継承元 DbCommand) |
DbTransaction |
この DbCommand オブジェクトが実行される DbTransaction を取得または設定します。 (継承元 DbCommand) |
DesignMode |
Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component) |
DesignTimeVisible |
コマンド オブジェクトをカスタマイズされたインターフェイス コントロールに表示する必要があるかどうかを示す値を取得または設定します。 |
Events |
Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component) |
Parameters |
OdbcParameterCollection を取得します。 |
Site |
Component の ISite を取得または設定します。 (継承元 Component) |
Transaction |
OdbcTransaction が実行される OdbcCommand を取得または設定します。 |
UpdatedRowSource |
Update メソッドがコマンドの結果を DataRow に適用する方法を示す値を取得または設定します。 |
メソッド
Cancel() |
OdbcCommand の実行のキャンセルを試行します。 |
CreateDbParameter() |
DbParameter オブジェクトの新しいインスタンスを作成します。 (継承元 DbCommand) |
CreateObjRef(Type) |
リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。 (継承元 MarshalByRefObject) |
CreateParameter() |
OdbcParameter オブジェクトの新しいインスタンスを作成します。 |
Dispose() |
アンマネージ リソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。 (継承元 DbCommand) |
Dispose() |
Component によって使用されているすべてのリソースを解放します。 (継承元 Component) |
Dispose(Boolean) |
DbCommand によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 (継承元 DbCommand) |
Dispose(Boolean) |
Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。 (継承元 Component) |
DisposeAsync() |
コマンド オブジェクトを非同期に破棄します。 (継承元 DbCommand) |
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
ExecuteDbDataReader(CommandBehavior) |
接続に対してコマンドを実行し、結果へのアクセスに使用できる を返 DbDataReader します。 (継承元 DbCommand) |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) |
プロバイダーは、ExecuteReader のオーバーロードに既定以外の実装を提供するには、このメソッドを実装する必要があります。 既定の実装は ExecuteReader() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteReader によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 このメソッドは、早期に操作をキャンセルすることを要求するために使用できるキャンセル トークンを受け取ります。 実装は、この要求を無視する場合があります。 (継承元 DbCommand) |
ExecuteNonQuery() |
Connection に対して SQL ステートメントを実行し、影響を受けた行数を返します。 |
ExecuteNonQueryAsync() |
非同期バージョンの ExecuteNonQuery()。 の接続オブジェクトに対してコマンドを実行し、影響を受ける行数を返します。 CancellationToken.None を使用して、ExecuteNonQueryAsync(CancellationToken) を呼び出します。 (継承元 DbCommand) |
ExecuteNonQueryAsync(CancellationToken) |
これは ExecuteNonQuery() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。 既定の実装は ExecuteNonQuery() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteNonQuery() によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 返されたタスクが完了するまで |
ExecuteReader() |
CommandText を Connection に送信し、OdbcDataReader を構築します。 |
ExecuteReader(CommandBehavior) |
CommandText を Connection に送信し、 |
ExecuteReaderAsync() |
非同期バージョンの ExecuteReader。 の接続に対してコマンドを実行し DbDataReader 、結果へのアクセスに使用できる を返します。 CancellationToken.None を使用して、ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。 (継承元 DbCommand) |
ExecuteReaderAsync(CancellationToken) |
非同期バージョンの ExecuteReader。 の接続に対してコマンドを実行し DbDataReader 、結果へのアクセスに使用できる を返します。 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。 (継承元 DbCommand) |
ExecuteReaderAsync(CommandBehavior) |
非同期バージョンの ExecuteReader。 の接続に対してコマンドを実行し DbDataReader 、結果へのアクセスに使用できる を返します。 ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。 (継承元 DbCommand) |
ExecuteReaderAsync(CommandBehavior, CancellationToken) |
ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) を呼び出します。 (継承元 DbCommand) |
ExecuteScalar() |
クエリを実行し、クエリによって返される結果セットの先頭行の最初の列を返します。 その他の列または行は無視されます。 |
ExecuteScalarAsync() |
の非同期バージョン ExecuteScalar()。 コマンドを実行し、最初に返された結果セットの最初の行の最初の列を返します。 その他の列、行、結果セットはすべて無視されます。 CancellationToken.None を使用して、ExecuteScalarAsync(CancellationToken) を呼び出します。 (継承元 DbCommand) |
ExecuteScalarAsync(CancellationToken) |
これは ExecuteScalar() の非同期バージョンです。 プロバイダーは、適切な実装でオーバーライドする必要があります。 オプションで、キャンセル トークンを無視できます。 既定の実装は ExecuteScalar() 同期メソッドを呼び出し、完了したタスクを返します。呼び出し元のスレッドはブロックされます。 既定の実装は、既に取り消されたキャンセル トークンを渡した場合、取り消されたタスクを返します。 ExecuteScalar によってスローされる例外は、返されたタスクの Exception プロパティを介して通信されます。 返されたタスクが完了するまで |
GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
GetLifetimeService() |
古い.
対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
GetService(Type) |
Component またはその Container で提供されるサービスを表すオブジェクトを返します。 (継承元 Component) |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
InitializeLifetimeService() |
古い.
このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。 (継承元 MarshalByRefObject) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
MemberwiseClone(Boolean) |
現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。 (継承元 MarshalByRefObject) |
Prepare() |
データ ソースにコマンドの準備済みまたはコンパイル済みバージョンを作成します。 |
PrepareAsync(CancellationToken) |
準備済み (またはコンパイル済み) バージョンのコマンドをデータ ソース上に非同期に作成します。 (継承元 DbCommand) |
ResetCommandTimeout() |
CommandTimeout プロパティを既定値にリセットします。 |
ToString() |
Component の名前 (存在する場合) を格納する String を返します。 このメソッドはオーバーライドできません。 (継承元 Component) |
イベント
Disposed |
Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component) |
明示的なインターフェイスの実装
ICloneable.Clone() |
このメンバーの詳細については、「Clone()」をご覧ください。 |
IDbCommand.Connection |
この IDbCommand のインスタンスで使用する IDbConnection を取得または設定します。 (継承元 DbCommand) |
IDbCommand.CreateParameter() |
IDbDataParameter オブジェクトの新しいインスタンスを作成します。 |
IDbCommand.CreateParameter() |
IDbDataParameter オブジェクトの新しいインスタンスを作成します。 (継承元 DbCommand) |
IDbCommand.ExecuteReader() |
この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 Connection に対して CommandText を実行し、IDataReader をビルドします。 |
IDbCommand.ExecuteReader() |
Connection に対して CommandText を実行し、IDataReader をビルドします。 (継承元 DbCommand) |
IDbCommand.ExecuteReader(CommandBehavior) |
この API は製品インフラストラクチャをサポートします。コードから直接使用するものではありません。 Connection に対して CommandText を実行し、指定した動作を使用して IDataReader をビルドします。 |
IDbCommand.ExecuteReader(CommandBehavior) |
Connection に対して CommandText を実行し、CommandBehavior の値のいずれかを使用して IDataReader をビルドします。 (継承元 DbCommand) |
IDbCommand.Parameters |
IDataParameterCollection を取得します。 (継承元 DbCommand) |
IDbCommand.Transaction |
この DbCommand オブジェクトが実行される DbTransaction を取得または設定します。 (継承元 DbCommand) |
拡張メソッド
ConfigureAwait(IAsyncDisposable, Boolean) |
非同期の破棄可能から返されるタスク上での待機がどのように実行されるかを構成します。 |
適用対象
こちらもご覧ください
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示