Record オブジェクト (ADO)Record Object (ADO)

行を表す、 Recordsetまたはデータ プロバイダー、あるいはファイルやディレクトリなどの半構造化データ プロバイダーによって返されるオブジェクト。Represents a row from a Recordset or the data provider, or an object returned by a semi-structured data provider, such as a file or directory.


Aレコードオブジェクトは、データの 1 つの行を表しており、1 つの行といくつかの概念の類似性を持つRecordsetします。A Record object represents one row of data, and has some conceptual similarities with a one-row Recordset. プロバイダーの機能に応じてレコードオブジェクトは、1 つの行ではなく、プロバイダーから直接返される可能性がありますRecordsetときに 1 行のみを選択する SQL クエリの例は、実行されます。Depending on the capabilities of your provider, Record objects may be returned directly from your provider instead of a one-row Recordset, for example when an SQL query that selects only one row is executed. または、レコードから直接オブジェクトを取得できる、 Recordsetオブジェクト。Or, a Record object can be obtained directly from a Recordset object. または、レコードMicrosoft Exchange の OLE DB プロバイダーなどの半構造化データに、プロバイダーから直接返されることができます。Or, a Record can be returned directly from a provider to semi-structured data, such as the Microsoft Exchange OLE DB provider.

関連付けられているフィールドを表示することができます、レコードでのオブジェクト、フィールドコレクションに、レコードオブジェクト。You can view the fields associated with the Record object by way of the Fields collection on the Record object. ADO では、オブジェクトの値を持つ列を含むRecordsetSafeArrayとでスカラー値、フィールドのコレクションレコードオブジェクト。ADO allows object-valued columns including Recordset, SafeArray, and scalar values in the Fields collection of Record objects.

場合、レコードオブジェクト内の行を表します、レコード セットはその元に返すことのできるレコード セットで、ソースプロパティ。If the Record object represents a row in a Recordset, it is possible to return to that original Recordset with the Source property.

レコードオブジェクトも使用できますで半構造化データ プロバイダーなど、 Microsoft OLE DB Provider for Internet Publishing、ツリー構造の名前空間をモデル化します。The Record object can also be used by semi-structured data providers such as the Microsoft OLE DB Provider for Internet Publishing, to model tree-structured namespaces. ツリー内の各ノードは、レコード関連付けられている列を持つオブジェクト。Each node in the tree is a Record object with associated columns. 列には、そのノードとその他の関連情報の属性を表すことができます。The columns can represent the attributes of that node and other relevant information. レコードオブジェクトは、リーフ ノードとツリー構造内の非リーフ ノードの両方を表すことができます。The Record object can represent both a leaf node and a non-leaf node in the tree structure. 非リーフ ノードは、それらの内容として他のノードがリーフ ノードには、このような内容はありません。Non-leaf nodes have other nodes as their contents, but leaf nodes do not have such contents. 通常、リーフ ノードにはデータのバイナリ ストリームが含まれてし、非リーフ ノードはそれらに関連付けられている既定のバイナリ ストリームにもあります。Leaf nodes typically contain binary streams of data and non-leaf nodes may also have a default binary stream associated with them. プロパティをレコードオブジェクトは、ノードの種類を識別します。Properties on the Record object identify the type of node.

レコードオブジェクトは、編成されたデータを階層的に移動するのも、別の方法を表します。The Record object also represents an alternative way for navigating hierarchically organized data. Aレコードオブジェクトは、大規模なツリー構造内の特定のサブツリーのルートを表すために作成され、新しい可能性がありますレコード子ノードを表すオブジェクトを開くことができます。A Record object may be created to represent the root of a specific sub-tree in a large tree structure and new Record objects may be opened to represent child nodes.

(たとえば、ファイルまたはディレクトリ) のリソースは、絶対 URL で一意に識別できます。A resource (for example, a file or directory) can be uniquely identified by an absolute URL. A接続オブジェクトが暗黙的に作成されに設定、レコードオブジェクトと、レコードが絶対 URL を使用して開きます。A Connection object is implicitly created and set to the Record object when the Record is opened by using an absolute URL. A接続オブジェクト明示的に設定する、レコードオブジェクトを使用して、 ActiveConnectionプロパティ。A Connection object may explicitly be set to the Record object via the ActiveConnection property. ファイルとディレクトリを使用してアクセスできる、接続オブジェクトの定義、コンテキストレコード操作が発生する可能性があります。The files and directories that can be accessed by using the Connection object define the context in which Record operations may occur.

データの変更とナビゲーション メソッド、レコードオブジェクトには、絶対 URL を使用してリソースを検索、相対 URL もそのまま使用または接続開始点として、オブジェクト コンテキスト。Data modification and navigation methods on the Record object also accept a relative URL, which locates a resource using an absolute URL or the Connection object context as a starting point.


Http スキームを使用して Url が自動的に呼び出さ、 Microsoft OLE DB Provider for Internet Publishingします。URLs using the http scheme will automatically invoke the Microsoft OLE DB Provider for Internet Publishing. 詳細については、次を参照してください。絶対と相対 Urlします。For more information, see Absolute and Relative URLs.

A接続オブジェクトが互いに関連付けられているレコードオブジェクト。A Connection object is associated with each Record object. そのため、レコードオブジェクトの操作を呼び出すことによって、トランザクションの一部をすることができます接続オブジェクトのトランザクション メソッドです。Therefore, Record object operations can be part of a transaction by invoking Connection object transaction methods.

レコードオブジェクトは、ADO のイベントをサポートしないし、通知には応答しません。The Record object does not support ADO events, and therefore will not respond to notifications.

メソッドとプロパティの使用、レコードオブジェクトを次を行うことができます。With the methods and properties of a Record object, you can do the following:

  • 設定または取得、関連付けられている接続オブジェクトをActiveConnectionプロパティ。Set or return the associated Connection object with the ActiveConnection property.

  • アクセス許可を示す、モードプロパティ。Indicate access permissions with the Mode property.

  • によって表されるリソースが含まれている場合に、ディレクトリの URL を返す、レコードで、 ParentURLプロパティ。Return the URL of the directory, if any, that contains the resource represented by the Record with the ParentURL property.

  • 絶対 URL で、相対 URL を指定またはレコード セット元となる、レコードは派生した、ソースプロパティ。Indicate the absolute URL, relative URL, or Recordset from which the Record is derived with the Source property.

  • 現在の状態を示す、レコードで、状態プロパティ。Indicate the current status of the Record with the State property.

  • 種類を示すレコード - 単純コレクション、または構造化ドキュメント- で、 RecordTypeプロパティ。Indicate the type of Record - simple, collection, or structured document - with the RecordTypeproperty.

  • 使用して、非同期操作の実行を停止、キャンセルメソッド。Stop execution of an asynchronous operation with the Cancel method.

  • 関連付けを解除、レコードでデータ ソースから、閉じるメソッド。Disassociate the Record from a data source with the Close method.

  • コピーしたファイルまたはディレクトリで表される、レコードで別の場所に、 CopyRecordメソッド。Copy the file or directory represented by a Record to another location with the CopyRecord method.

  • 削除、ファイルまたはディレクトリとサブディレクトリをによって表される、レコードで、 DeleteRecordメソッド。Delete the file, or directory and subdirectories, represented by a Record with the DeleteRecord method.

  • 開く、 Recordsetによって表されるエンティティのファイルとサブディレクトリを表す行を格納している、レコードで、 GetChildrenメソッド。Open a Recordset that contains rows that represent the subdirectories and files of the entity represented by the Record with the GetChildren method.

  • 移動 (変更)、ファイルまたはディレクトリとサブディレクトリ、によって表される、レコードで別の場所に、 MoveRecordメソッド。Move (rename) the file, or directory and subdirectories, represented by a Record to another location with the MoveRecord method.

  • 関連付ける、レコードに既存のデータ ソース、または新しいファイルまたはディレクトリを作成、オープンメソッド。Associate the Record with an existing data source, or create a new file or directory with the Open method.

レコードオブジェクトがスクリプトを実行します。The Record object is safe for scripting.

このセクションには、次のトピックが含まれています。This section contains the following topic.

参照See Also

フィールド コレクション (ADO) Fields Collection (ADO)
Properties コレクション (ADO) Properties Collection (ADO)
レコードとストリーム Records and Streams
Recordset オブジェクト (ADO)Recordset Object (ADO)