サンプルコードで学ぶASP

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

構文

object.Close

パラメータ

説明

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

Close メソッドを使って Recordset オブジェクト、Record オブジェクト、または Stream オブジェクトを閉じると、関連するデータと、そのデータに対するこのオブジェクトからの排他アクセスがすべて解放されます。その後で Open メソッドを呼び出して、同じ属性または更新された属性を持つオブジェクトを再度開くことができます。

Recordset オブジェクトが閉じているときに、開いているカーソルを必要とするメソッドを呼び出すと、エラーが発生します。

即時更新モードで編集しているときに Close メソッドを呼び出すと、エラーが発生します。この場合は、先に Update メソッドまたは CancelUpdate メソッドを呼び出してください。バッチ更新モードの実行中に Recordset オブジェクトを閉じると、最後に UpdateBatch メソッドを実行した後に行われた変更がすべて失われます。

Clone メソッドを使って開いている Recordset オブジェクトのコピーを作成した場合、元のオブジェクトまたはクローンを閉じてもほかのコピーには影響しません。

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

構文

object.Cancel

パラメータ

設定値と戻り値

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

説明

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

オブジェクトを開いているか閉じているか、データ ソースに接続中か、コマンドを実行中か、またはデータを取得中かどうかを表します。

PWS4 IIS4 IIS5)
State — 対象になるすべてのオブジェクトについて、そのオブジェクトが開いているか、または閉じているかを示します。
非同期メソッドを実行している対象の全オブジェクトについて、そのオブジェクトが現在、接続、実行、取得のどの状態であるかを示します。

構文

object.State

パラメータ

戻り値

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

説明

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

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

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

(PWS4)
Source — Record で表されるデータ ソースまたはオブジェクトを示します。

構文

object.Source

パラメータ

設定値と戻り値

Record が表すエンティティを示す文字列型 (String) の値を設定します。また、値の取得も可能です。

説明

Source プロパティは、Record オブジェクトの Open メソッドの Source 引数を返します。絶対 URL または相対 URL の文字列を格納します。絶対 URL では、ActiveConnection プロパティを設定せずに Record オブジェクトを直接開くことができます。この場合、暗黙の Connection オブジェクトが作成されます。

Source プロパティには、開いている Recordset に対する参照も格納できます。この参照では、Recordset の現在の行を表す Record オブジェクトが開かれます。

また、Source プロパティには、プロバイダから 1 つのデータ行を返す Command オブジェクトへの参照も格納することができます。

ActiveConnection プロパティも設定するときは、接続範囲内にあるオブジェクトを Source プロパティで指定します。たとえば、ツリー構造の名前空間では、Source プロパティに絶対 URL が指定されている場合、接続文字列内の URL で指定したノードの適用範囲内にあるノードを指定している必要があります。Source プロパティに相対 URL が指定されている場合、ActiveConnection プロパティで設定されたコンテキスト内で有効となります。

Source プロパティは、Record オブジェクトが閉じているときは読み取り/書き込み可能になり、Record オブジェクトが開いているときは読み取り専用になります。

(PWS4 IIS4 IIS5)
RecordType — Record オブジェクトのタイプを示します。

構文

object.RecordType

パラメータ

戻り値

RecordTypeEnum 値を返します。

説明

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

(PWS4 IIS4 IIS5)
Mode — Connection オブジェクト、Record オブジェクト、または Stream オブジェクトで使用可能なデータ変更権限を示します。

構文

object.Mode

パラメータ

設定値と戻り値

ConnectModeEnum の値を設定します。また、値の取得も可能です。Connection の既定値は adModeUnknown です。Record オブジェクトの既定値は adModeRead です。基になるソースに関連付けられている Stream (URL により、ソース、または Record の既定 Stream として開かれたもの) の既定値は、adModeRead です。基になるソースに関連付けられていない (メモリ内でインスタンス作成された) Stream の既定値は、adModeUnknown です。

説明

現在の接続でプロバイダが使用しているアクセス権は、Mode プロパティを使って設定または取得します。Mode プロパティは、Connection オブジェクトが閉じている場合のみ設定できます。

Stream オブジェクトでは、アクセス モードを指定しない場合、Stream オブジェクトを開くときに使うソースのモードが継承されます。たとえば、Record オブジェクトから Stream を開くと、既定では Record と同じモードで開きます。

このプロパティは、オブジェクトが閉じているときは読み取り/書き込み可能になり、オブジェクトが開いているときは読み取り専用になります。

RDS での使用 クライアント側の Connection オブジェクトで使う場合、Mode プロパティは adModeUnknown にのみ設定できます。

(PWS4 IIS4 IIS5)
ActiveConnection — 指定した Command オブジェクト、Recordset オブジェクト、または Record オブジェクトが、現在どの Connection オブジェクトに属するかを示します。

構文

object.ActiveConnection

パラメータ

設定値と戻り値

接続が切断された場合は接続定義を格納する文字列型 (String) の値、また、接続が開かれている場合はカレントの Connection オブジェクトを格納したバリアント型 (Variant) の値を設定します。また、値の取得も可能です。既定は Null オブジェクトへの参照です。

説明

Record オブジェクトを閉じるとこのプロパティは読み取り/書き込み可能になり、接続文字列または開かれた Connection オブジェクトに対する参照が格納されます。Record オブジェクトを開くとこのプロパティは読み取り専用になり、開かれた Connection オブジェクトに対する参照が格納されます。

URL から Record オブジェクトを開くと、Connection オブジェクトが無条件で作成されます。既存の開かれた Connection オブジェクトで Record を開くには、Connection オブジェクトをこのプロパティに割り当てるか、Open メソッドを呼び出す際のパラメータとして Connection オブジェクトを使用します。既存の Record や Recordset から開いた Record は、Record オブジェクトや Recordset オブジェクトの Connection オブジェクトに自動的に関連付けられます。