資料列集

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

下載 OLE DB 驅動程式

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

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

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

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

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

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

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

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

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

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

本節內容

• 以 IOpenRowset 建立資料列集

• 使用 ICommand:: Execute 建立資料列集

• 資料列集屬性和行為

• 資料列集和 SQL Server 資料指標

• 擷取資料列

• 使用 IRow 擷取單一資料列

• 書籤

• 更新資料列集中的資料

另請參閱

OLE DB Driver for SQL Server 程式設計