記錄和 Provider-Supplied 欄位
開啟 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 成員為零。 |
資源_流尺寸 | 作為無符號大整數 | 唯讀的。 表示資源的預設數據流大小,以位元組為單位。 |
RESOURCE_ISCOLLECTION | AdBoolean | 唯讀的。 如果資源是集合,例如目錄,則為 True。 如果資源是簡單的檔案,則為 False。 |
資源_是結構化文件 | AdBoolean | 如果資源是結構化檔,則為 True。 如果資源不是結構化檔,則為 False。 它可以是集合或簡單的檔案。 |
預設文件 | AdVarWChar | 唯讀。 表示此資源包含資料夾或結構化檔之預設簡單檔的URL。 當從資源要求預設數據流時使用。 這個屬性對簡單檔案而言是空白的。 |
章節化的孩子們 | 廣告章節 | 唯讀的。 自選。 表示包含資源子系之數據列集的章節。 (OLE DB Provider for Internet Publishing 不使用此欄位。) |
RESOURCE_DISPLAYNAME | AdVarWChar | 唯讀的。 指出資源的顯示名稱。 |
RESOURCE_ISROOT | AdBoolean | 唯讀的。 如果資源是集合或結構化檔的根目錄,則為 True。 |