15.5.1 HiRDBCommand
- 〈この項の構成〉
(1) コンストラクタ
(a) HiRDBCommand
- void HiRDBCommand ()
-
説明:HiRDBCommandの新しいインスタンスを初期化します。
- void HiRDBCommand (string)
-
- 引数
-
string cmdText:SQLテキスト(CommandTextプロパティ)
説明:SQLテキストを指定して,HiRDBCommandクラスの新しいインスタンスを初期化します。
- void HiRDBCommand (string, Hitachi.HiRDB.HiRDBConnection)
-
- 引数
-
string cmdText:SQLテキスト(CommandTextプロパティ)
HiRDBConnection rConnection:データベースへの接続を表すHiRDBConnectionオブジェクト(Connectionプロパティ)
説明:SQLテキストとHiRDBConnectionオブジェクトを使用して,HiRDBCommandクラスの新しいインスタンスを初期化します。
- void HiRDBCommand (string, Hitachi.HiRDB.HiRDBConnection, Hitachi.HiRDB.HiRDBTransaction)
-
- 引数
-
string cmdText:SQLテキスト(CommandTextプロパティ)
HiRDBConnection rConnection:データベースへの接続を表すHiRDBConnectionオブジェクト(CommandTextプロパティ)
HiRDBTransaction rTransaction:HiRDBCommandを実行するHiRDBTransactionオブジェクト(Transactionプロパティ)
説明:SQLテキスト,HiRDBConnection オブジェクト,及びHiRDBTransaction オブジェクトを使用して,HiRDBCommandクラスの新しいインスタンスを初期化します。
(2) プロパティ
(a) CommandText
型:string
既定値:""
説明:データベースに対して実行するテキストコマンドを取得又は設定します。
(b) CommandTimeout
型:int
既定値:30
説明:SQL実行のタイムアウト時間(秒数)を取得又は設定します。
例外:HiRDBException
(c) CommandType
型:System.Data.CommandType
既定値:CommandType.Text
説明:CommandTextプロパティの解釈方法を取得又は設定します。
(d) Connection
型:HiRDBConnection
既定値:null
説明:このHiRDBCommandで使用されるHiRDBConnectionを取得又は設定します。
例外:HiRDBException
(e) DesignTimeVisible
型:bool
既定値:true
説明:インタフェースコントロールにHiRDBCommandオブジェクトを連携した場合に,HiRDBCommandオブジェクトをコントロール上に表示するかどうかを示す値を取得又は設定します。
(f) Parameters
型:HiRDBParameterCollection
説明:HiRDBParameterCollectionを取得します(読み取り専用)。
(g) Transaction
型:HiRDBTransaction
既定値:null
説明:このHiRDBCommandが実行されるHiRDBTransactionを取得又は設定します。
(h) UpdatedRowSource
型:System.Data.UpdateRowSource
既定値:UpdatedRowSource.None
説明:HiRDBDataAdapterのUpdateメソッドがコマンド結果を使用するときに,コマンド結果をDataRowに適用する方法を取得又は設定します。
例外:HiRDBException
(3) メソッド
(a) Cancel
void Cancel ()
Return:void
説明:HiRDBCommandの実行中のSQLをキャンセルします。
(b) Clone
object Clone ()
- Return
-
object:このインスタンスのコピーである新しいオブジェクト
説明:現在のインスタンスのコピーである新しいオブジェクトを作成します。
(c) CreateParameter
Hitachi.HiRDB.HiRDBParameter CreateParameter ()
- Return
-
HiRDBParameter:HiRDBParameterオブジェクト
説明:HiRDBParameterオブジェクトの新しいインスタンスを作成します。
(d) Dispose
void Dispose()
Return:void
説明:HiRDBCommandが使用しているすべてのリソースを解放します。
(e) ExecuteNonQuery
- int ExecuteNonQuery ()
-
- Return
-
int:影響を受けた行の数
説明:HiRDBConnectionオブジェクトに対してSQLステートメントを実行し,影響を受けた行の数を返します。
例外:HiRDBException
- int ExecuteNonQuery (int)
-
- 引数
-
int nArraySize:配列要素数
- Return
-
int:影響を受けた行の数
説明:配列を使用したINSERT機能を使用し,HiRDBConnectionオブジェクトに対してSQLステートメントを実行し,影響を受けた行の数を返します。
例外:HiRDBException
(f) ExecuteReader
- Hitachi.HiRDB.HiRDBDataReader ExecuteReader ()
-
- Return
-
HiRDBDataReader:HiRDBDataReaderオブジェクト
説明:HiRDBConnectionに対してCommandTextを実行し,HiRDBDataReader を構築します。
例外:HiRDBException
- ExecuteReader (System.Data.CommandBehavior)
-
- 引数
-
System.DataCommandBehavior behavior:CommandBehavior値の一つ
- Return
-
HiRDBDataReader:HiRDBDataReaderオブジェクト
説明:HiRDBConnectionに対してCommandTextを実行し,CommandBehavior値の一つを使用してHiRDBDataReaderを構築します。
例外:HiRDBException
(g) ExecuteScalar
object ExecuteScalar ()
- Return
-
object:結果セットの最初の行にある最初の列
説明:クエリを実行し,そのクエリが .NET Frameworkのデータ型で返す結果セットの最初の行の最初の列を返します。残りの列又は行は無視されます。
例外:HiRDBException
(h) Prepare
void Prepare ()
Return:void
説明:準備されたバージョンのコマンド(コンパイル済み)をデータベースに作成します。
例外:HiRDBException