サンプルコードで学ぶASP

(PWS4 IIS4 IIS5)
RollbackTrans — * すべての変更をキャンセルして現在のトランザクションを終了します。新規トランザクションを開始する場合もあります。

構文

object.RollbackTrans

パラメータ

説明

RollbackTrans メソッドを呼び出すと、最後に開いたトランザクションのみを操作します。さらに上のレベルのトランザクションを処理するには、カレント トランザクションを閉じるか、またはロール バックする必要があります。

RollbackTrans メソッドを呼び出すと、その接続上で開いているトランザクションに加えたすべての変更が元に戻され、トランザクションが終了します。開いているトランザクションが存在しないときに RollbackTrans メソッドを呼び出すと、エラーが発生します。

(PWS4 IIS4 IIS5)
OpenSchema — プロバイダからデータベースのスキーマ情報を取得します。

Set recordset = connection.OpenSchema (QueryType, Criteria, SchemaID)

パラメータ

戻り値

スキーマ情報を含む Recordset オブジェクトを返します。Recordset は、読み取り専用の静的カーソルとして開かれます。Recordset に表示される列は、QueryType によって決まります。

説明

OpenSchema メソッドは、データ ソースに含まれるテーブル、テーブルに含まれる列、サポートされているデータ型など、そのデータ ソースの内容に関する情報を返します。

QueryType 引数は、返される列 (スキーマ) を示す GUID です。OLE DB の仕様には、すべてのスキーマの一覧があります。

Criteria 引数は、スキーマ クエリの結果を制限します。Criteria は、結果の Recordset で、該当する列のサブセット (“制約列”) に表示する値の配列を指定します。

プロバイダが独自に定義しているOLE DB 仕様以外の非標準スキーマ クエリを指定する場合は、QueryType 引数に adSchemaProviderSpecific 定数を使用します。この定数を使用する場合は、SchemaID 引数に、実行するスキーマクエリの GUID を指定する必要があります。QueryType が adSchemaProviderSpecific に設定され、SchemaID が指定されていない場合は、エラーが発生します。

プロバイダは、すべての OLE DB 標準スキーマ クエリをサポートする必要はありません。OLE DB の仕様では、adSchemaTables、adSchemaColumns、および adSchemaProviderTypes のみが必要とされます。ただし、これらのスキーマ クエリでは、プロバイダは Criteria の制約をサポートする必要はありません。

RDS での使用 OpenSchema メソッドは、クライアント側の Connection オブジェクトでは使用できません。

(PWS4 IIS4 IIS5)
Open — データ ソースへの接続を開きます。

connection.Open ConnectionString, UserID, Password, Options

パラメータ

説明

Connection オブジェクトで Open メソッドを使うと、データ ソースへの物理的な接続を確立できます。このメソッドが正常に終了すると、接続が有効になり、この接続に対してコマンドを実行し、その結果を処理することができます。

ConnectionString 引数は、セミコロンで区切られた一連の “引数 = 値” のステートメントから成る接続文字列を指定するか、または URL で識別されるファイルまたはディレクトリのリソースを指定する場合に使用します。ConnectionString プロパティは、ConnectionString 引数の値を自動的に継承します。したがって、Connection オブジェクトを開く前に ConnectionString プロパティを設定するか、または Open メソッドの呼び出し時に ConnectionString 引数を使って現在の接続パラメータを設定または上書きします。

ConnectionString 引数にユーザーおよびパスワードの情報を指定し、同時に UserID 引数と Password 引数も指定した場合は、UserID 引数と Password 引数に指定された値が ConnectionString 引数に指定された値より優先されます。

開いている Connection オブジェクトでの操作が完了したら、Close メソッドを使って関連するすべてのシステムリソースを解放します。オブジェクトを閉じてもメモリからは削除されないので、そのオブジェクトのプロパティ設定を変更し、Open メソッドを使ってもう一度開くことができます。オブジェクトをメモリから完全に削除するには、オブジェクト変数に Nothing を設定します。

RDS での使用 クライアント側の Connection オブジェクトで Open メソッドを使用する場合、その Connection オブジェクトで Recordset が開かれるまで、サーバーへの接続は確立されません。

(PWS4 IIS4 IIS5)
Execute — 指定されたクエリ、SQL ステートメント、ストアド プロシージャ、またはプロバイダ固有のテキストを実行します。

戻り値

Recordset オブジェクトへの参照を返します。

パラメータ

説明

Connection オブジェクトで Execute メソッドを使用すると、指定した接続上で、CommandText 引数に指定したクエリが実行されます。CommandText 引数に、行を返すクエリが指定されている場合、クエリの実行結果はすべて新規 Recordset オブジェクトに保存されます。行を返すクエリ以外のコマンドの場合は、プロバイダは閉じた Recordset オブジェクトを返します。

返された Recordset オブジェクトは常に読み取り専用で、前方スクロールタイプのカーソルです。Recordset オブジェクトに、より多くの機能が必要な場合は、まず、目的のプロパティ設定を持つ Recordset オブジェクトを作成し、次に、Recordset オブジェクトの Open メソッドを使ってクエリを実行して目的のカーソルの種類を返します。

CommandText 引数の内容はプロバイダに固有のものであり、標準の SQL 構文、またはプロバイダがサポートする固有のコマンド形式を使用できます。

この操作が完了すると ExecuteComplete イベントが発生します。

(PWS4 IIS4 IIS5)
CommitTrans — べての変更を保存して現在のトランザクションを終了します。新規トランザクションを開始する場合もあります。

設定値と戻り値

プロバイダで使用可能なデータベース名を評価する文字列型 (String) の値を設定します。また、値の取得も可能です。

説明

CommitTrans メソッドを呼び出すと、最後に開いたトランザクションのみを操作します。さらに上のレベルのトランザクションを処理するには、カレント トランザクションを閉じるか、またはロール バックする必要があります。

CommitTrans メソッドを呼び出すと、その接続上で開いているトランザクションに加えた変更が保存され、トランザクションが終了します。

(PWS4 IIS4 IIS5)
Close — 開いているオブジェクトおよびそれに従属するすべてのオブジェクトを閉じます。

object.Close

説明

Close メソッドを使って、Connection オブジェクト、Record オブジェクト、Recordset オブジェクト、または Stream オブジェクトを閉じ、関連するすべてのシステムリソースを解放します。オブジェクトを閉じてもメモリからは削除されず、プロパティ設定を変更してもう一度開くことができます。メモリからオブジェクトを完全に削除するには、オブジェクトを閉じて、オブジェクト変数を Nothing (Visual Basic の場合) に設定します。

Close メソッドを使って Connection オブジェクトを閉じると、その接続に関連するアクティブな Recordset オブジェクトもすべて閉じます。Connection オブジェクトに関連する Command オブジェクトはそのまま維持されますが、その ActiveConnection プロパティが Nothing に設定されると、Connection オブジェクトとの関連はなくなります。また、Command オブジェクトの Parameters コレクション内のプロバイダに定義されたパラメータはすべてクリアされます。

もう一度 Open メソッドを呼び出すと、同じまたは異なるデータ ソースへの接続が再度確立されます。Connection オブジェクトが閉じているときに、データ ソースへの接続を必要とするメソッドを呼び出すと、エラーが発生します。

接続上で Recordset オブジェクトを開いたまま Connection オブジェクトを閉じると、すべての Recordset オブジェクトの保留中の変更がすべてロール バックされます。トランザクションの処理中に Close メソッドを呼び出して明示的に Connection オブジェクトを閉じると、エラーが発生します。トランザクションの処理中に Connection オブジェクトが参照できない状態になると、ADO によりトランザクションが自動的にロール バックされます。

(PWS4 IIS4 IIS5)
Cancel — 非同期メソッド呼び出しのうち、保留中のものの実行をキャンセルします。

設定値と戻り値

Cancel メソッドを使って、非同期メソッド (adAsyncConnect、adAsyncExecute、または adAsyncFetch のオプションを指定して呼び出すメソッド) の呼び出しの実行を中止します。

説明

次の表は、各種のオブジェクトで Cancel メソッドを使用したときに中止される操作です。

(PWS4 IIS4 IIS5)
BeginTrans — 新規トランザクションを開始します。

戻り値

BeginTrans は、トランザクションのネスト レベルを示す長整数型 (Long) の変数を返す関数として呼び出すことができます。

説明

BeginTrans メソッドを呼び出すと、CommitTrans または RollbackTrans メソッドを呼び出してトランザクションを終了するまで、変更は実行されません。

ネストされたトランザクションをサポートしているプロバイダの場合、開いているトランザクションで BeginTrans メソッドを呼び出すと、ネストされた新規トランザクションが開始されます。戻り値は、ネストのレベルを示します。戻り値 “1” はトップレベルのトランザクション (ほかのトランザクション内でネストしていないトランザクション)、”2″ はセカンド レベルのトランザクション (トップ レベルのトランザクション内でネストしているトランザクション) が開いたことを示します (“3” 以下も同様です)。

(PWS4 IIS4 IIS5)
Versione — バージョンを示す長整数型 (Long) を返します。

説明

ADO 実装のバージョン番号を返すには、Version プロパティを使います。

プロバイダのバージョンは、Properties コレクションのダイナミック プロパティとして使用することができます。

(PWS4 IIS4 IIS5)
State — 対象になるすべてのオブジェクトについて、そのオブジェクトが開いているか、または閉じているかを示します。

object.State

戻り値

ObjectStateEnum 値となる長整数型 (Long) の値を返します。既定値は adStateClosed です。

説明

State プロパティを使えば、オブジェクトの現在の状態をいつでも調べることができます。

オブジェクトの State プロパティの値は組み合わせることができます。たとえば、ステートメントが実行中のときは、プロパティの値は adStateOpen と adStateExecuting の組み合わせになります。

State プロパティは読み取り専用です。