Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um conjunto de linhas é um conjunto de linhas que contêm colunas de dados. Conjuntos de linhas são objetos centrais que permitem que todos os provedores de dados OLE DB exponham dados do conjunto de resultados no formato tabular.
Depois que um consumidor cria 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 provedor OLE DB do SQL Server Native Client dá suporte a ambas as interfaces. Ambos os métodos são descritos aqui.
Crie um conjunto de linhas chamando o método IOpenRowset::OpenRowset .
Isso é equivalente à criação de um conjunto de linhas em uma única tabela. Esse método é aberto e retorna um conjunto de linhas que inclui todas as linhas de uma única tabela base. Um dos argumentos para OpenRowset é uma ID de tabela que identifica a tabela da qual criar o conjunto de linhas.
Crie um objeto de comando chamando o método IDBCreateCommand::CreateCommand .
O objeto de comando executa comandos compatíveis com o provedor. Com o provedor OLE DB do SQL Server Native Client, o consumidor pode especificar qualquer instrução Transact-SQL, como uma instrução SELECT ou uma chamada para um procedimento armazenado. As etapas para criar um conjunto de linhas usando um objeto de comando são:
O consumidor chama o método IDBCreateCommand::CreateCommand na sessão para obter um objeto de comando solicitando a interface ICommandText no objeto de comando. Essa interface ICommandText define e recupera o texto de comando real. O consumidor preenche o comando de texto chamando o método ICommandText::SetCommandText .
O usuário chama o método ICommand::Execute no comando. O objeto rowset criado 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 retornado pelo comando executado pelas interfaces ICommand::Execute . As propriedades mais solicitadas são as interfaces que o conjunto de linhas deve dar suporte. Além das interfaces, o consumidor pode solicitar propriedades que modifiquem o comportamento do conjunto de linhas ou interface.
Os consumidores liberam conjuntos de linhas com o método IRowset::Release . A liberação de um conjunto de linhas libera todos os identificadores de linha mantidos pelo consumidor nesse conjunto de linhas. A liberação de um conjunto de linhas não libera os acessadores. Se você tiver uma interface IAccessor , ela ainda precisará ser lançada.