レコードとプロバイダー供給のフィールド

適用先: Access 2013、Office 2013

Record オブジェクトが開かれると、そのソースは、開かれた Connection オブジェクトと共に動作する、開かれた Recordset のカレント行、絶対 URL、または相対 URL になることができます。

Record が Recordset から開かれる場合は、 Record オブジェクトの Fields コレクションには、 Recordset からのすべてのフィールドに加えて、基になるプロバイダーによって追加されたフィールドが含まれます。

プロバイダーは、 Record の補完機能として作用する追加フィールドを挿入することができます。 その結果、 Record には、 Recordset 全体、または Recordset の別の行から派生した Record にはない固有のフィールドが存在するようになります。

たとえば、電子メール データ ソースから派生した Recordset のすべての行に、From、To、Subject などの列が含まれる場合があります。 A Record derived from that Recordset will have the same fields. However, the Record may also have other fields unique to the particular message represented by that Record, such as Attachment and Cc (carbon copy).

Record オブジェクトと Recordset オブジェクトのカレント行には同じフィールドがありますが、 Record オブジェクトと Recordset オブジェクトには異なるメソッドとプロパティがあるので、この 2 つは別のものです。

Record オブジェクトと Recordset オブジェクトに共通して存在しているフィールドは、いずれかのオブジェクトで変更することができます。 ただし、基になるプロバイダーがフィールドを "Null" に設定できたとしても、 Record オブジェクトでフィールドを削除することはできません。

Record が開かれた後に、プログラムでフィールドを追加することができます。 また、追加したフィールドを削除することができますが、元の Recordset からフィールドを削除することはできません。

さらに、URL から Record オブジェクトを直接開くことができます。 この場合、 Record に追加されるフィールドは、基になるプロバイダーによって異なります。 現在ほとんどのプロバイダーでは、 Record で表されるエンティティを記述したフィールドのセットが追加されます。 エンティティが単純ファイルなどのバイトのストリームから構成されている場合、通常は Stream オブジェクトを Record から開くことができます。

ドキュメント ソース プロバイダー用の特殊なフィールド

ドキュメント ソース プロバイダーと呼ばれる特殊なプロバイダー クラスは、フォルダーとドキュメントを管理します。 When a Record object represents a document or a Recordset object represents a folder of documents, the document source provider populates those objects with a unique set of fields that describe characteristics of the document instead of the actual document itself. Typically, one field contains a reference to the Stream that represents the document.

これらのフィールドがリソースの record または recordset を形成していますが、これらのフィールドをサポートする特定のプロバイダーについてのフィールド一覧は、「 付録 A: プロバイダー」に記載されています。

リソースの Record または Recordset の Fields コレクションに 2 つの定数でインデックスを付けて、両方で共通して使用されるフィールドを取得します。 Field オブジェクトの Value プロパティが、要求された内容を返します。

• adDefaultStream 定数でアクセスされたフィールドには、 Record オブジェクトまたは Recordset オブジェクトに関連付けられた既定のストリームが含まれます。 プロバイダーは、既定のストリームをオブジェクトに割り当てます。

• adRecordURL 定数でアクセスされたフィールドには、ドキュメントを識別する絶対 URL が含まれます。

ドキュメント ソース プロバイダーでは、 Record オブジェクトと Field オブジェクトの Properties コレクションはサポートされません。 Properties コレクションの内容は、このようなオブジェクトに対しては Null です。

ドキュメント ソース プロバイダーで、ドキュメント ソース プロバイダーかどうかを識別する Datasource Type などのプロバイダー特有のプロパティを追加することができます。 使用しているプロバイダーの種類を調べる方法の詳細については、そのプロバイダーのマニュアルを参照してください。

リソース レコードセットの列

"リソース レコードセット" は、次の列で構成されています。

列名	型	説明
RESOURCE_PARSENAME	AdVarWChar	読み取り専用です。 リソースの URL を示します。
RESOURCE_PARENTNAME	AdVarWChar	読み取り専用です。 親レコードの絶対 URL を示します。
RESOURCE_ABSOLUTEPARSENAME	AdVarWChar	読み取り専用です。 リソースの絶対 URL、つまり PARENTNAME と PARSENAME の連結を示します。
RESOURCE_ISHIDDEN	AdBoolean	リソースが非表示状態であれば True です。 RESOURCE_ISHIDDEN が True の行を、行セットを作成するコマンドが明示的に選択しない限り、行は返されません。
RESOURCE_ISREADONLY	AdBoolean	リソースが読み取り専用であれば True です。 DBBINDFLAG_WRITE でこのリソースを開こうとすると、DB_E_READONLY が設定され、失敗します。 リソースが読み取り専用で開かれた場合でも、このプロパティは編集することができます。
RESOURCE_CONTENTTYPE	AdVarWChar	たとえば、法律家の書類などの、ドキュメントの使用方法を示します。 これは、ドキュメントの作成に使用される Office テンプレートに対応付けることができます。
RESOURCE_CONTENTCLASS	AdVarWChar	ドキュメントの MIME の種類を示し、"text/html" などの形式を示します。
RESOURCE_CONTENTLANGUAGE	AdVarWChar	内容がどの言語で保存されるかを示します。
RESOURCE_CREATIONTIME	adFileTime	読み取り専用です。 リソースが作成された時刻を含んだ FILETIME 構造を示します。 時刻は、Coordinated Universal Time (UTC) 形式で報告されます。
RESOURCE_LASTACCESSTIME	AdFileTime	読み取り専用です。 リソースが最後にアクセスされた時刻を含んだ FILETIME 構造を示します。 時刻は UTC 形式です。 プロバイダーでこの時刻メンバーがサポートされない場合、FILETIME メンバーは 0 です。
RESOURCE_LASTWRITETIME	AdFileTime	読み取り専用です。 リソースが最後に書き込まれた時刻を含んだ FILETIME 構造を示します。 時刻は UTC 形式です。 プロバイダーでこの時刻メンバーがサポートされない場合、FILETIME メンバーは 0 です。
RESOURCE_STREAMSIZE	asUnsignedBigInt	読み取り専用です。 リソースの既定のストリームのサイズをバイト数で示します。
RESOURCE_ISCOLLECTION	AdBoolean	読み取り専用です。 リソースがディレクトリなどのコレクションであれば True です。 リソースが単純ファイルの場合は False です。
RESOURCE_ISSTRUCTUREDDOCUMENT	AdBoolean	リソースが構造ドキュメントであれば True です。 リソースが構造ドキュメントでない場合は False です。 その場合は、コレクションまたは単純ファイルの可能性があります。
DEFAULT_DOCUMENT	AdVarWChar	読み取り専用です。 このリソースがフォルダーの既定の単純ドキュメントまたは構造ドキュメントへの URL を含んでいることを示します。 既定のストリームがリソースから要求されたときに使用されます。 このプロパティは、単純ファイルの場合は空白です。
CHAPTERED_CHILDREN	AdChapter	読み取り専用です。 省略可能です。 リソースの子を含む行セットの章を示します。 ( OLE DB Provider for Internet Publishing では、この列は使用されません)。
RESOURCE_DISPLAYNAME	AdVarWChar	読み取り専用です。 リソースの表示名を示します。
RESOURCE_ISROOT	AdBoolean	読み取り専用です。 リソースがコレクションのルートまたは構造ドキュメントであれば True です。