資料列集

適用範圍: 是SQL Server (所有支援的版本) 是Azure SQL Database 是Azure SQL 受控執行個體 是Azure Synapse Analytics 是平行處理資料倉儲

下載下載 OLE DB 驅動程式

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

取用者使用 IDBCreateSession::CreateSession 方法建立工作階段之後,就可以使用工作階段上的 IOpenRowsetIDBCreateCommand 介面建立資料列集。 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 介面,仍然必須釋放該介面。

本節內容

另請參閱

OLE DB Driver for SQL Server 程式設計