Record 物件 (ADO)

  • 發行項

代表來自資料錄集或資料提供者的資料列，或半結構化資料提供者所傳回的物件，例如檔案或目錄。

備註

Record 物件代表一個資料列，在概念上與單列資料錄集有些相似。 視提供者的功能而定，Record 物件可直接從提供者 (而不是單列資料錄集) 傳回，例如，執行僅選取一個資料列的 SQL 查詢時。 或者，可以直接從 Recordset 物件取得 Record 物件。 或者，記錄可以直接從提供者傳回至半結構化資料，例如 Microsoft Exchange OLE DB 提供者。

您可以透過 Record 物件上的 Fields 集合，檢視與 Record 物件相關聯的欄位。 ADO 允許物件值資料行，包括 Recordset、SafeArray，和 Record 物件之 Fields 集合中的純量值。

如果 Record 物件代表資料錄集中的資料列，則可以傳回至具有 Source 屬性的原始資料錄集。

Record 物件也可由半結構化資料提供者 (例如 Microsoft OLE DB Provider for Internet Publishing) 用來建立樹狀結構命名空間的模型。 樹狀結構中的每個節點都是具有相關資料行的 Record 物件。 資料行可以代表該節點的屬性和其他相關資訊。 Record 物件可代表樹狀結構中的分葉節點和非分葉節點。 非分葉節點具有其他節點作為其內容，而分葉節點則沒有這類內容。 分葉節點通常包含二進位資料流，而非分葉節點也可能有相關聯的預設二進位資料流。 Record 物件上的屬性會識別節點的類型。

Record 物件也代表瀏覽階層組織資料的替代方式。 您可以建立 Record 物件來代表大型樹狀結構中特定子樹狀結構的根目錄，並且可開啟新的 Record 物件來代表子節點。

資源 (例如檔案或目錄) 可用絕對 URL 來唯一識別。 使用絕對 URL 開啟記錄時，會隱含地建立 Connection 物件，並將其設定為 Record 物件。 Connection 物件可透過 ActiveConnection 屬性明確地設定為 Record 物件。 可使用 Connection 物件存取的檔案和目錄，會定義可能發生 Record 作業的內容。

Record 物件上的資料修改和導覽方法也接受相對 URL，會使用絕對 URL 或 Connection 物件內容作為起點來尋找資源。

注意

使用 http 配置的 URL 會自動叫用 Microsoft OLE DB Provider for Internet Publishing。 如需詳細資訊，請參閱絕對和相對 URL。

一個 Connection 物件會分別與一個 Record 物件相關聯。 因此，Record 物件作業可藉由叫用 Connection 物件交易方法成為交易的一部分。

Record 物件不支援 ADO 事件，因此不會回應通知。

您可以使用 Record 物件的方法和屬性來執行下列動作：

  • 使用 ActiveConnection 屬性設定或傳回相關聯的 Connection 物件。

  • 使用 Mode 屬性指出存取權限。

  • 使用 ParentURL 屬性傳回目錄的 URL (如果有的話)，其中包含記錄所代表的資源。

  • 使用 Source 屬性指出從中衍生記錄的絕對 URL、相對 URL 或資料錄集。

  • 使用 State 屬性指出記錄的目前狀態。

  • 使用 RecordType 屬性指出 Record - 簡單、集合或結構化檔的類型。

  • 使用 Cancel 方法停止執行非同步作業。

  • 使用 Close 方法將記錄與資料來源解除關聯。

  • 使用 CopyRecord 方法，將 Record 所代表的檔案或目錄複製到另一個位置。

  • 使用 DeleteRecord 方法刪除記錄所代表的檔案或目錄和子目錄。

  • 使用 GetChildren 方法開啟資料錄集，其中有資料列代表記錄所代表之實體的子目錄和檔案。

  • 使用 MoveRecord 方法，將 Record 所代表的檔案或目錄和子目錄移至 (重新命名到) 另一個位置。

  • 使用 Open 方法將記錄與現有的資料來源建立關聯，或建立新的檔案或目錄。

Record 物件對於撰寫指令碼而言是安全的。

本節包含下列主題。

另請參閱

Fields 集合 (ADO)
Properties 集合 (ADO)
記錄和資料流
Recordset 物件 (ADO)