共用方式為

  • 發行項

資料列集

資料列集是一組資料列，其中包含資料的資料行。資料列集是能讓所有 OLE DB 資料提供者公開表格形式結果集資料的核心物件。

取用者使用 IDBCreateSession::CreateSession 方法建立工作階段之後，就可以使用工作階段上的 IOpenRowset 或 IDBCreateCommand 介面建立資料列集。SQL Server Native Client OLE DB 提供者同時支援這兩種介面。此處描述這兩種方法。

  • 呼叫 IOpenRowset::OpenRowset 方法來建立資料列集。

    這相當於在單一資料表上建立資料列集。此方法會從單一基底資料表開啟並傳回包含所有資料列的資料列集。其中的 OpenRowset 引數是資料表識別碼，可識別要從中建立資料列集的資料表。

  • 呼叫 IDBCreateCommand::CreateCommand 方法來建立命令物件。

    命令物件會執行提供者支援的命令。利用 SQL Server Native Client OLE DB 提供者，取用者可以指定任何 Transact-SQL 陳述式，例如 SELECT 陳述式或預存程序的呼叫。使用命令物件建立資料列集的步驟如下：

    1. 取用者會呼叫工作階段上的 IDBCreateCommand::CreateCommand 方法來取得在命令物件上要求 ICommandText 介面的命令物件。這個 ICommandText 介面會設定及擷取實際的命令文字。取用者會呼叫 ICommandText::SetCommandText 方法來填入文字命令。

    2. 使用者會針對命令呼叫 ICommand::Execute 方法。命令執行時所建立的資料列集物件包含來自命令的結果集。

取用者可以使用 ICommandProperties 介面來取得或設定 ICommand::Execute 介面所執行之命令傳回的資料列集屬性。最常要求的屬性為資料列集必須支援的介面。除了介面之外，取用者可以要求修改資料列集或介面之行為的屬性。

取用者會利用 IRowset::Release 方法釋放資料列集。釋放資料列集時，也會釋放取用者在該資料列集上保留的所有資料列控制代碼。釋放資料列集不會釋放存取子。如果您有 IAccessor 介面，仍然必須釋放該介面。