レコードと Provider-Supplied フィールド
Record オブジェクトを開くと、そのソースには、開いている Recordsetの現在の行、絶対 URL、または開いている Connection オブジェクトと組み合わせた相対 URL を指定できます。
Recordsetから Record を開くと、Record オブジェクト Fields コレクションには、Recordsetのすべてのフィールドと、基になるプロバイダーによって追加されたすべてのフィールドが含まれます。
プロバイダーは、レコードの補足特性として機能する追加のフィールドを挿入できます。 その結果、レコード には、Recordset 全体に含まれていない一意のフィールドや、Recordsetの別の行から派生した Record があります。
たとえば、電子メール データ ソースから派生した Recordset のすべての行に、From、To、Subject などの列がある場合があります。 レコード は レコードセット から派生し、同じフィールドを持ちます。 ただし、レコード には、添付ファイルや CC (カーボン コピー) など、その レコードによって表される特定のメッセージに固有のフィールドが含まれる場合もあります。
Record オブジェクトと Recordset の現在の行は同じフィールドを持ちますが、Record オブジェクトと Recordset オブジェクトのメソッドとプロパティが異なるため、異なります。
Record と Recordset によって共通に保持されているフィールドは、どちらのオブジェクトでも変更できます。 ただし、Record オブジェクトではフィールドを削除できませんが、基になるプロバイダーはフィールドの null への設定をサポートしている場合があります。
Record を開いた後は、プログラムでフィールドを追加できます。 追加したフィールドを削除することもできますが、元の Recordsetからフィールドを削除することはできません。
Record オブジェクトを URL から直接開くこともできます。 この場合、Record に追加されるフィールドは、基になるプロバイダーによって異なります。 現在、ほとんどのプロバイダーは、Recordによって表されるエンティティを記述するフィールドのセットを追加します。 エンティティが単純なファイルなどのバイト ストリームで構成されている場合は、通常、Stream オブジェクトを Recordから開くことができます。
ドキュメント ソース プロバイダーの特殊フィールド
ドキュメント ソース プロバイダー と呼ばれる特別なクラスのプロバイダーは、フォルダーとドキュメントを管理します。 Record オブジェクトがドキュメントを表す場合、または Recordset オブジェクトがドキュメントのフォルダーを表す場合、ドキュメント ソース プロバイダーは、実際のドキュメント自体ではなく、ドキュメントの特性を説明する一意のフィールド セットをそれらのオブジェクトに設定します。 通常、1 つのフィールドには、ドキュメントを表す Stream への参照が含まれています。
これらのフィールドは、リソース レコード またはレコード セット を構成し、「付録 A: Providers」でサポートする特定のプロバイダーについて一覧表示されます。
2つの定数は、リソースレコードのコレクションに属するフィールド、またはレコードセットのインデックスを作成して、一般的によく使われるフィールドのペアを取得します。 Field オブジェクト Value プロパティは、目的のコンテンツを返します。
adDefaultStream 定数でアクセスされるフィールドには、Record または Recordset オブジェクトに関連付けられた既定のストリーム 含まれています。 プロバイダーは、既定のストリームをオブジェクトに割り当てます。
adRecordURL 定数でアクセスされるフィールドには、ドキュメントを識別する絶対 URL が含まれています。
ドキュメント ソース プロバイダーは、Record オブジェクトと Field オブジェクトの Properties コレクションをサポートしていません。 このようなオブジェクトの Properties コレクションの内容は null です。
ドキュメント ソース プロバイダーは、データソースの種類 などのプロバイダー固有のプロパティを追加して、それがドキュメント ソース プロバイダーであるかどうかを識別できます。 プロバイダーの種類を決定する方法の詳細については、プロバイダーのドキュメントを参照してください。
リソース レコードセット列
リソース レコードセット は、次の列で構成されます。
| 列名 | タイプ | 説明 |
|---|---|---|
| リソース_パースネーム | AdVarWChar | 読み取り専用。 リソースの URL を示します。 |
| リソース_親名 | AdVarWChar | 読み取り専用。 親レコードの絶対 URL を示します。 |
| RESOURCE_ABSOLUTEPARSENAME (リソース_絶対パース名) | AdVarWChar | 読み取り専用。 リソースの絶対 URL (PARENTNAME と PARSENAME の連結) を示します。 |
| RESOURCE_ISHIDDEN | AdBoolean | リソースが非表示の場合は True。 行セットを作成するコマンドで、RESOURCE_ISHIDDENが True の行を明示的に選択しない限り、行は返されません。 |
| リソースは読み取り専用です | AdBoolean | リソースが読み取り専用の場合は True。 DBBINDFLAG_WRITEでこのリソースを開こうとすると、DB_E_READONLYで失敗します。 このプロパティは、リソースが読み取り専用に開かれている場合でも編集できます。 |
| リソース_コンテンツタイプ | AdVarWChar | ドキュメントの使用の可能性を示します。たとえば、弁護士の簡単な説明です。 これは、ドキュメントの作成に使用された Office テンプレートに対応している場合があります。 |
| RESOURCE_CONTENTCLASS | AdVarWChar | "text/html" などの形式を示す、ドキュメントの MIME の種類を示します。 |
| リソース_コンテンツ_言語 | AdVarWChar | コンテンツが格納される言語を示します。 |
| リソース作成時間 | adFileTime (アドファイルタイム) | 読み取り専用。 リソースが作成された時刻を含む FILETIME 構造体を示します。 時刻は協定世界時 (UTC) 形式で報告されます。 |
| RESOURCE_LASTACCESSTIME | AdFileTime | 読み取り専用。 リソースが最後にアクセスされた時刻を含む FILETIME 構造体を示します。 時刻は UTC 形式です。 プロバイダーが今回のメンバーをサポートしていない場合、FILETIME メンバーは 0 になります。 |
| 資源_最終更新時刻 | AdFileTime | 読み取り専用。 リソースが最後に書き込まれた時刻を含む FILETIME 構造体を示します。 時刻は UTC 形式です。 プロバイダーが今回のメンバーをサポートしていない場合、FILETIME メンバーは 0 になります。 |
| RESOURCE_STREAMSIZE | 符号なしビッグイントとして (asUnsignedBigInt) | 読み取り専用。 リソースの既定のストリームのサイズをバイト単位で示します。 |
| RESOURCE_ISCOLLECTION | AdBoolean | 読み取り専用。 True リソースがディレクトリなどのコレクションである場合です。 リソースが単純なファイルの場合は False。 |
| 構造化ドキュメントリソース | AdBoolean | リソースが構造化ドキュメントの場合は True。 リソースが構造化ドキュメントでない場合は False。 コレクションまたは単純なファイルを指定できます。 |
| デフォルト文書 | AdVarWChar | 読み取り専用。 このリソースに、フォルダーまたは構造化ドキュメントの既定の単純なドキュメントへの URL が含まれていることを示します。 既定のストリームがリソースから要求されたときに使用されます。 このプロパティは、単純なファイルの場合は空白です。 |
| チャプター分けされた子供たち | 広告章 | 読み取り専用。 随意。 リソースの子を含む行セットのセクションを示します。 (OLE DB Provider for Internet Publishing では、この列は使用されません)。 |
| リソース表示名 | AdVarWChar | 読み取り専用。 リソースの表示名を示します。 |
| RESOURCE_ISROOT | AdBoolean | 読み取り専用。 リソースがコレクションまたは構造化ドキュメントのルートである場合は True。 |