3.13.2　プロパティとメソッドの制限

プロパティとメソッドは，サーバプログラムと接続していないとエラーになることがあります。プロパティとメソッドの状態遷移を表3-15に示します。表3-15にある「×」は，エラーになることを示します。表3-15に記載していないプロパティとメソッドは，状態遷移による制限はありません。

表3-15に示す状態は，次に示す4種類あります。

• 未接続：サーバプログラムと接続していない状態を示します。

• 接続：サーバプログラムと接続している状態を示します。

• 前処理：Select系SQL文を実行した状態を示します。

• 取得：抽出結果の取得中の状態を示します。

  表3‒15　プロパティとメソッドの状態遷移

  オブジェクト		プロパティ 又はメソッド	状態
  			１：未接続	２：接続	３：前処理	４：取得
  DBPARTNER		Cancel	１※1	２※1	２※2	２※2
  		Disconnect	１※3	１	×	×
  		Commit	×	２※4	２※5	２※5
  		Rollback	×	２※4	２※5	２※5
  		Connect	２	２※6	×	×
  	SQLDirect	Execute	×	３ 又は ２※7	×	×
  	Result	RecordHeader	×	×	３	４
  		FieldHeader	×	×	３	４
  		RecordData	×	×	×	４
  		FieldData	×	×	×	４
  		FieldDataB	×	×	×	４
  		FieldType	×	×	３	４
  		FieldDataLength	×	×	×	４
  		FieldCount	１※8	２※8	３	４
  		Get	×	×	４ 又は ２※9	４ 又は ２※9
  		Close	１※3	２※3	２	２
  		SaveLargeObject	×	×	×	４
  		SaveToFile	×	×	２	×
  		CopyToClipboard	×	×	２	×
  	TableList	Get	×	２	×	×
  	ColumnList	Get	×	２	×	×
  	QueryDefine	QueryCount	×	２	×	×
  		Execute	×	３	×	×
  	UpdateDefine	Execute	×	２	×	×

  注※1

  Cancelは正常に終了します。

  注※2

  Cancelが正常に受け付けられたときは遷移します。受け付けられなかったときは遷移しません。

  注※3

  何も処理しません。

  注※4

  Commit/Rollbackメソッドは正常に終了します。

  注※5

  Commit/Rollbackメソッドを処理した後で，DBPARTNER2 Clientが自動的にCloseメソッドを実行します。

  注※6

  現在の接続を終了した後で，接続を再開始します。

  注※7

  Select系のSQLを実行した場合は「3」。それ以外は「2」に遷移します。

  注※8

  0を返します。

  注※9

  最終データまで取得したとき，又はエラーになったときは，「2」に遷移します。

ページの先頭へ