15.5.1　HiRDBCommand

(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クラスの新しいインスタンスを初期化します。

(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

(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