Поделиться через


Наборы строк

Набор строк — это набор строк, содержащих столбцы данных. Наборы строк — это центральные объекты, позволяющие всем поставщикам данных OLE DB предоставлять данные результирующих наборов в табличной форме.

Когда потребитель создает сеанс с помощью метода IDBCreateSession::CreateSession , потребитель может использовать интерфейс IOpenRowset или IDBCreateCommand в сеансе для создания набора строк. Поставщик OLE DB собственного клиента SQL Server поддерживает оба этих интерфейса. Оба этих метода описаны здесь.

  • Создайте набор строк, вызвав метод IOpenRowset::OpenRowset .

    Это эквивалентно созданию набора строк по одной таблице. Этот метод открывает и возвращает набор строк, включающий все строки из одной базовой таблицы. Одним из аргументов OpenRowset является идентификатор таблицы, определяющий таблицу, из которой создается набор строк.

  • Создайте объект команды, вызвав метод IDBCreateCommand::CreateCommand .

    Объект команды выполняет команды, поддерживаемые поставщиком. С помощью поставщика OLE DB собственного клиента SQL Server потребитель может указать любую Transact-SQL инструкцию, например инструкцию SELECT или вызов хранимой процедуры. Ниже приведены действия по созданию набора строк с помощью объекта команды:

    1. Потребитель вызывает метод IDBCreateCommand::CreateCommand в сеансе, чтобы получить объект команды, запрашивающий интерфейс ICommandText в объекте команды. Этот интерфейс ICommandText задает и извлекает фактический текст команды. Потребитель заполняет текстовую команду путем вызова метода ICommandText::SetCommandText .

    2. Пользователь вызывает метод ICommand::Execute в команде. Объект набора строк, созданный при выполнении команды, содержит результирующий набор из команды.

Потребитель может использовать интерфейс ICommandProperties для получения или задания свойств набора строк, возвращаемого командой, выполняемой интерфейсами ICommand::Execute . Наиболее часто запрашиваемые свойства — это интерфейсы, которые должен поддерживать набор строк. Помимо интерфейсов, потребитель может запрашивать свойства, изменяющие поведение набора строк или интерфейса.

Потребители выпускают наборы строк с помощью метода IRowset::Release . Освобождение набора строк освобождает все дескрипторы строк, удерживаемые потребителем в этом наборе строк. Освобождение набора строк не освобождает методы доступа. Если у вас есть интерфейс IAccessor , он по-прежнему должен быть выпущен.

В этом разделе

См. также

SQL Server Native Client (OLE DB)