開啟 Record 物件時,其來源可以是開啟的 Recordset的目前數據列、絕對 URL、或者是結合開啟的 Connection 物件的相對 URL。
如果 Record 是從 Recordset開啟,Record 物件 Fields 集合會包含來自 Recordset的所有字段,以及基礎提供者新增的任何字段。
提供者可能會插入其他欄位,作為 記錄的補充特性。 因此,Record 可能擁有 Recordset 整體或任何從 Recordset另一個數據列派生的 Record 中不存在的唯一字段。
例如,源自電子郵件數據源的 資料集 中所有的資料列可能包含如同 From、To 和 Subject 等欄位。 衍生自該 recordset Recordset 的 Record 將會有相同的欄位。 不過,記錄 也可能包含該 記錄所代表的特定郵件中,具唯一性的其他欄位,例如附件和副本。
雖然 Record 物件和 Recordset 的目前數據列具有相同字段,但它們不同,因為 Record 和 Recordset 物件有不同的方法和屬性。
Record 和 Recordset 共同擁有的欄位可以在任一物件上修改。 不過,無法在 Record 物件上刪除欄位,不過基礎提供者可能支援將字段設定為 null。
開啟 Record 之後,您可以以程式設計方式新增欄位。 您也可以刪除已新增的欄位,但無法從原始 Recordset刪除欄位。
您也可以直接從 URL 開啟 Record 物件。 在此情況下,新增至 Record 的欄位 取決於基礎提供者。 目前,大部分提供者都會新增一組字段,以描述 Record 所代表的實體。 如果實體是由位元組數據流所組成,例如簡單的檔案,通常可以從 Record開啟 Stream 物件。
文件來源提供者的特殊欄位
稱為 文件來源提供者的特殊類別提供者會管理資料夾和檔。 當 Record 物件代表檔或 Recordset 物件代表檔的資料夾時,檔來源提供者會以描述檔特性的唯一字段集填入這些物件,而不是實際檔本身。 一般而言,一個欄位包含代表文件之 Stream 的參考。
這些欄位構成資源 記錄 或 記錄集,並列於附錄 A:提供者 中支持這些欄位的特定提供者。
兩個常數會為 Fields 集合的資源類型 Record 或 Recordset 做索引,以擷取一對常用的字段。 Field 物件 Value 屬性會傳回所需的內容。
使用 adDefaultStream 常數存取的欄位包含與 Record 或 Recordset 物件相關聯的預設數據流。 提供者會將預設數據流指派給物件。
使用 adRecordURL 存取的欄位 常數包含識別文件的絕對 URL。
檔來源提供者不支援 Record 和 Field 物件的 Properties 集合。 這類物件的 Properties 集合內容為 null。
文件來源提供者可以新增提供者特定的屬性,例如 數據源類型,以識別它是否為文檔來源提供者。 如需如何判斷提供者類型的詳細資訊,請參閱提供者檔。
資源記錄集欄位
資源記錄集 包含下列數據行。
欄位名稱 | 類型 | 描述 |
---|---|---|
RESOURCE_PARSENAME | AdVarWChar | 唯讀的。 指出資源的URL。 |
RESOURCE_PARENTNAME | AdVarWChar | 唯讀的。 表示父記錄的絕對 URL。 |
RESOURCE_ABSOLUTEPARSENAME | AdVarWChar | 唯讀的。 指出資源的絕對 URL,也就是 PARENTNAME 和 PARSENAME 的串連。 |
RESOURCE_ISHIDDEN | AdBoolean | 當資源被隱藏時,此值為 True。 除非建立數據列集的命令明確選取RESOURCE_ISHIDDEN為 True 的數據列,否則不會傳回任何數據列。 |
唯讀資源 | AdBoolean | 若資源為只讀則為 True。 嘗試用 DBBINDFLAG_WRITE 開啟此資源,會失敗並提示 DB_E_READONLY。 即使資源已開啟以供讀取,也可以編輯這個屬性。 |
RESOURCE_CONTENTTYPE | AdVarWChar | 指示文件的可能用途,例如律師的摘要。 這可能對應至用來建立檔的 Office 範本。 |
資源_內容類別 | AdVarWChar | 指出檔的 MIME 類型,表示格式,例如 「text/html 」。。 |
資源_內容語言 | AdVarWChar | 指出儲存內容的語言。 |
資源_創建時間 | adFileTime | 唯讀的。 表示包含資源建立時間的 FILETIME 結構。 時間會以國際標準時間 (UTC) 格式報告。 |
資源_最後存取時間 | AdFileTime | 唯讀的。 指出 FILETIME 結構,其中包含上次存取資源的時間。 時間是以UTC格式。 如果提供者不支援這個時間成員,則 FILETIME 成員為零。 |
資源_最後寫入時間 | AdFileTime | 唯讀的。 指出 FILETIME 結構,其中包含上次寫入資源的時間。 時間是以UTC格式。 如果提供者不支援這個時間成員,則 FILETIME 成員為零。 |
資源_流尺寸 | 作為無符號大整數 | 唯讀的。 表示資源的預設數據流大小,以位元組為單位。 |
資源_是集合 | AdBoolean | 唯讀的。 如果資源是集合,例如目錄,則為 True。 如果資源是簡單的檔案,則為 False。 |
資源_是結構化文件 | AdBoolean | 如果資源是結構化檔,則為 True。 如果資源不是結構化檔,則為 False。 它可以是集合或簡單的檔案。 |
預設文件 | AdVarWChar | 唯讀的。 表示此資源包含資料夾或結構化檔之預設簡單檔的URL。 當從資源要求預設數據流時使用。 這個屬性對簡單檔案而言是空白的。 |
章節化的孩子們 | 廣告章節 | 唯讀的。 自選。 表示包含資源子系之數據列集的章節。 (OLE DB Provider for Internet Publishing 不使用此欄位。) |
RESOURCE_DISPLAYNAME | AdVarWChar | 唯讀的。 指出資源的顯示名稱。 |
RESOURCE_ISROOT | AdBoolean | 唯讀的。 如果資源是集合或結構化檔的根目錄,則為 True。 |