Conjuntos de linhas

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Base de dados SQL no Microsoft Fabric

Baixar driver OLE DB

Um conjunto de linhas é um conjunto de linhas que contêm colunas de dados. Os conjuntos de linhas são objetos centrais que permitem a todos os fornecedores de dados do OLE DB expor os dados do conjunto de resultados em forma tabular.

Depois de um consumidor criar uma sessão usando o método IDBCreateSession::CreateSession , o consumidor pode usar a interface IOpenRowset ou IDBCreateCommand na sessão para criar um conjunto de linhas. O Driver OLE DB para SQL Server suporta ambas as interfaces. Ambos os métodos são descritos aqui.

• Crie um conjunto de linhas chamando o método IOpenRowset::OpenRowset .

  Isto equivale a criar um conjunto de linhas sobre uma única tabela. Este método abre e devolve um conjunto de linhas que inclui todas as linhas de uma única tabela base. Um dos argumentos para o OpenRowSet é um ID de tabela que identifica a tabela a partir da qual criar o conjunto de linhas.

• Crie um objeto de comando chamando o método IDBCreateCommand::CreateCommand .

  O objeto de comando executa comandos que o fornecedor suporta. Com o Driver OLE DB para SQL Server, o consumidor pode especificar qualquer instrução Transact-SQL, como uma instrução SELECT ou uma chamada a um procedimento armazenado. Os passos para criar um conjunto de linhas usando um objeto de comando são:

  1. O consumidor chama o método IDBCreateCommand::CreateCommand na sessão para obter um objeto de comando que solicita a interface ICommandText no objeto de comando. Esta interface ICommandText define e recupera o texto real do comando. O consumidor preenche o comando texto chamando o método ICommandText::SetCommandText .

  2. O utilizador chama o método ICommand::Execute no comando. O objeto de linhas construído quando o comando é executado contém o conjunto de resultados do comando.

O consumidor pode usar a interface ICommandProperties para obter ou definir as propriedades do conjunto de linhas devolvidas pelo comando executado pelas interfaces ICommand::Executar . As propriedades mais frequentemente solicitadas são as interfaces que o conjunto de linhas deve suportar. Para além das interfaces, o consumidor pode solicitar propriedades que modificam o comportamento do conjunto de linhas ou interface.

Os consumidores libertam conjuntos de linhas com o método IRowset::Release . Libertar um conjunto de linhas liberta quaisquer handles de linha mantidos pelo consumidor nesse conjunto de linhas. Libertar um conjunto de linhas não liberta os acessórios. Se tiveres uma interface de IAccessor , ainda assim tem de ser libertada.

Na presente seção

• Criar um Conjunto de Linhas com o IOpenRowSet

• Criação de Conjuntos de Linhas com ICommand::Execute

• Propriedades e Comportamentos do Conjunto de Linhas

• Conjuntos de Linhas e Cursores SQL Server

• Remates de Busca

• Buscar uma Única Linha com IRow

• Bookmarks

• Atualização de Dados em Conjuntos de Linhas

Ver também

Driver OLE DB para programação do SQL Server