Record オブジェクト (ADO)

  • [アーティクル]

Recordset またはデータ プロバイダーの一行、またはファイルやディレクトリなどの半構造化データ プロバイダーによって返されるオブジェクトを表します。

解説

Record オブジェクトは 1 行のデータを表し、1 行の Recordset と概念的な類似点があります。 プロバイダーの機能によっては、レコード オブジェクトが 1 行の Recordset ではなくプロバイダーから直接返される場合があります。たとえば、1 行のみを選択する SQL クエリが実行される場合です。 または、Record オブジェクトは、Recordset オブジェクトから直接取得できます。 または、Record をプロバイダーから、Microsoft Exchange OLE DB プロバイダーなどの半構造化データに直接返すことができます。

Record オブジェクトに関連付けられているフィールドは、Record オブジェクトの Fields コレクションを使用して表示できます。 ADO では、Record オブジェクトの Fields コレクションに Recordset、SafeArray、スカラー値を含むオブジェクト値列を使用できます。

Record オブジェクトが Recordset 内の 1 行を表す場合は、Source プロパティを使用してその元の Recordset に戻ることができます。

Record オブジェクトは、ツリー構造の名前空間をモデル化するために、Microsoft OLE DB Provider for Internet Publishing などの半構造化データ プロバイダーで使用することもできます。 ツリー内の各ノードは、関連付けられた列を含む Record オブジェクトです。 列は、そのノードの属性とその他の関連情報を表すことができます。 Record オブジェクトは、ツリー構造のリーフ ノードと非リーフ ノードの両方を表すことができます。 非リーフ ノードは、その内容として他のノードを保持しますが、リーフ ノードにはそのような内容はありません。 リーフ ノードには通常、データのバイナリ ストリームが含まれており、非リーフ ノードには既定のバイナリ ストリームが関連付けられている場合もあります。 Record オブジェクトのプロパティで、ノードの種類を識別します。

また、Record オブジェクトは、階層構造のデータ間を移動するための代替方法も表します。 大きなツリー構造内の特定のサブツリーのルートを表すために Record オブジェクトが作成される場合や、子ノードを表すために新しい Record オブジェクトがオープンされる場合があります。

リソース (ファイルやディレクトリなど) は、絶対 URL で一意に識別できます。 絶対 URL を使用して Record がオープンされると、Connection オブジェクトが暗黙的に作成され、Record オブジェクトに設定されます。 Connection オブジェクトは、ActiveConnection プロパティを使用して Record オブジェクトに明示的に設定できます。 Connection オブジェクトを使用してアクセスできるファイルとディレクトリでは、Record 操作が発生する可能性がある "コンテキスト" を定義します。

Record オブジェクトのデータ変更およびナビゲーションの各メソッドでは相対 URL も許容されます。これは、絶対 URL または Connection オブジェクト コンテキストを開始点として使用してリソースを特定します。

Note

http スキームを使用する URL は、Microsoft OLE DB Provider for Internet Publishing を自動的に呼び出します。 詳細については、「絶対 URL と相対 URL」を参照してください。

Connection オブジェクトは、各 Record オブジェクトに関連付けられます。 したがって、Record オブジェクトの操作は、Connection オブジェクト トランザクション メソッドを呼び出して、トランザクションの一部となることができます。

Record オブジェクトは ADO イベントをサポートしていないため、通知に応答しません。

Record オブジェクトのメソッドとプロパティを使用して、以下を行うことができます。

  • ActiveConnection プロパティに関連付けられている Connection オブジェクトを設定するか、返します。

  • Mode プロパティを使用してアクセス許可を示します。

  • ParentURL プロパティを持つ Record で表されるリソースを含むディレクトリの URL (存在する場合) を返します。

  • 絶対 URL、相対 URL、または Source プロパティを使用して Record が導出される Recordset を示します。

  • State プロパティを使用して Record の現在の状態を示します。

  • RecordType プロパティを使用して、Record - 単純、コレクション、または構造化ドキュメントの種類を示します。

  • Cancel メソッドを使用して非同期操作の実行を停止します。

  • Close メソッドを使用して、データ ソースから Record の関連付けを解除します。

  • CopyRecord メソッドを使用して、Record で表されるファイルまたはディレクトリを別の場所にコピーします。

  • DeleteRecord メソッドを使用して、Record で表されるファイルまたはディレクトリとサブディレクトリを削除します。

  • GetChildren メソッドを使用して、Record で表されるエンティティのサブディレクトリとファイルを表す行を含む Recordset をオープンします。

  • MoveRecord メソッドを使用して、Record で表されるファイルまたはディレクトリとサブディレクトリを別の場所に移動 (名前変更) します。

  • Record を既存のデータ ソースに関連付けるか、Open メソッドを使用して新しいファイルまたはディレクトリを作成します。

Record オブジェクトでは、安全にスクリプトを作成することができます。

このセクションでは、次のトピックを扱います。

参照

Fields コレクション (ADO)
Properties コレクション (ADO)
レコードとストリーム
Recordset オブジェクト (ADO)