スケーラブルデータベースサーバ HiRDB Version 8 UAP開発ガイド

[目次][索引][前へ][次へ]

16.5.1 HiRDBCommand

<この項の構成>
(1) コンストラクタ
(2) プロパティ
(3) メソッド

(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) ExecuteNonQuery

int ExecuteNonQuery ()
Return
int:影響を受けた行の数
説明:HiRDBConnectionオブジェクトに対してSQLステートメントを実行し,影響を受けた行の数を返します。
例外:HiRDBException

int ExecuteNonQuery (int)
引数
int nArraySize:配列要素数
Return
int:影響を受けた行の数
説明:配列を使用したINSERT機能を使用し,HiRDBConnectionオブジェクトに対してSQLステートメントを実行し,影響を受けた行の数を返します。
例外:HiRDBException
(e) 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
(f) ExecuteScalar

object ExecuteScalar ()

Return
object:結果セットの最初の行にある最初の列

説明:クエリを実行し,そのクエリが .NET Frameworkのデータ型で返す結果セットの最初の行の最初の列を返します。残りの列又は行は無視されます。

例外:HiRDBException

(g) Prepare

void Prepare ()

Return:void

説明:準備されたバージョンのコマンド(コンパイル済み)をデータベースに作成します。

例外:HiRDBException