Recordset またはデータ プロバイダーの行、またはファイルやディレクトリなどの半構造化データ プロバイダーによって返されるオブジェクトを表します。
注釈
Record オブジェクトは 1 行のデータを表し、1 行 Recordset といくつかの概念的な類似点があります。 プロバイダーの機能によっては、 レコード オブジェクトが 1 行の Recordset ではなくプロバイダーから直接返される場合があります。たとえば、1 行のみを選択する SQL クエリが実行される場合です。 または、 Record オブジェクトは Recordset オブジェクトから直接取得できます。 または、 レコード をプロバイダーから、Microsoft Exchange OLE DB プロバイダーなどの半構造化データに直接返すことができます。
Record オブジェクトに関連付けられているフィールドは、 Record オブジェクトの Fieldsコレクションを使用 して表示できます。 ADO では、Record オブジェクトの Fields コレクション内の Recordset、SafeArray、スカラー値などのオブジェクト値列を使用できます。
Record オブジェクトが Recordset 内の行を表す場合は、元の Recordset に戻り、Source プロパティを使用できます。
Record オブジェクトは、ツリー構造の名前空間をモデル化するために、Microsoft OLE DB Provider for Internet Publishing などの半構造化データ プロバイダーでも使用できます。 ツリー内の各ノードは、関連付けられた列を持つ Record オブジェクトです。 列は、そのノードの属性とその他の関連情報を表すことができます。 Record オブジェクトは、ツリー構造のリーフ ノードと非リーフ ノードの両方を表すことができます。 非リーフ ノードは、その内容として他のノードを持ちますが、リーフ ノードにはそのような内容はありません。 リーフ ノードには通常、データのバイナリ ストリームが含まれており、非リーフ ノードには既定のバイナリ ストリームが関連付けられている場合もあります。 Record オブジェクトのプロパティは、ノードの種類を識別します。
Record オブジェクトは、階層的に整理されたデータを移動するための別の方法も表します。 大きなツリー構造の特定のサブツリーのルートを表す Record オブジェクトを作成し、新しい Record オブジェクトを開いて子ノードを表す場合があります。
リソース (ファイルやディレクトリなど) は、絶対 URL で一意に識別できます。 Connection オブジェクトは、絶対 URL を使用して Record を開いたときに、暗黙的に作成され、Record オブジェクトに設定されます。 Connection オブジェクトは、ActiveConnection プロパティを使用して Record オブジェクトに明示的に設定できます。 Connection オブジェクトを使用してアクセスできるファイルとディレクトリは、Record操作が発生するコンテキストを定義します。
Record オブジェクトのデータ変更およびナビゲーション メソッドも相対 URL を受け入れます。相対 URL は、絶対 URL または Connection オブジェクト コンテキストを開始点として使用してリソースを検索します。
注
http スキームを使用する URL は、Microsoft OLE DB Provider for Internet Publishingを自動的に呼び出します。 詳細については、「絶対 URL と相対 URL を参照してください。
Connection オブジェクトは、各 Record オブジェクトに関連付けられています。 したがって、 Record オブジェクト操作は、 Connection オブジェクト トランザクション メソッドを呼び出すことによって、トランザクションの一部にすることができます。
Record オブジェクトは ADO イベントをサポートしていないため、通知に応答しません。
Record オブジェクトのメソッドとプロパティを使用すると、次の操作を実行できます。
ActiveConnection プロパティに関連付けられている Connection オブジェクトを設定または取得します。
Mode プロパティを使用してアクセス許可を示します。
ParentURL プロパティを持つ Record で表されるリソースを含むディレクトリの URL (存在する場合) を返します。
Source プロパティを使用してレコードの派生元となる絶対 URL、相対 URL、または Recordset を指定します。
State プロパティを使用して Record の現在の状態を示します。
RecordType プロパティを使用して、Record - simple、collection、または構造化ドキュメントの種類を示します。
Cancel メソッドを使用して非同期操作の実行を停止します。
Close メソッドを使用して、データ ソースから Record の関連付けを解除します。
CopyRecord メソッドを使用して、Record で表されるファイルまたはディレクトリを別の場所にコピーします。
DeleteRecord メソッドを使用して、Record で表されるファイルまたはディレクトリとサブディレクトリを削除します。
GetChildren メソッドを使用して、Record で表されるエンティティのサブディレクトリとファイルを表す行を含む Recordset を開きます。
MoveRecord メソッドを使用して、Record で表されるファイルまたはディレクトリとサブディレクトリを別の場所に移動 (名前変更) します。
Record を既存のデータ ソースに関連付けるか、Open メソッドを使用して新しいファイルまたはディレクトリを作成します。
Record オブジェクトは、スクリプト作成に安全です。
このセクションには、次のトピックが含まれています。
こちらもご覧ください
Fields コレクション (ADO)
プロパティコレクション (ADO)
レコードとストリーム
Recordset オブジェクト (ADO)