Метод Execute (RDS)
Выполняет запрос и создает набор записей ADO для использования в ADO 2.5 и более поздних версиях.
Важный
Начиная с Windows 8 и Windows Server 2012, компоненты сервера RDS больше не включены в операционную систему Windows (дополнительные сведения см. в статье Windows 8 и Windows Server 2012 Compatibility Cookbook). Клиентские компоненты RDS будут удалены в будущей версии Windows. Избегайте использования этой функции в новой работе разработки и планируйте изменение приложений, которые в настоящее время используют эту функцию. Приложения, использующие RDS, должны перенестися в службы данных WCF.
Синтаксис
object.Execute(ConnectionString As String, HandlerString As String, QueryString As String, lFetchOptions As Long, Properties, TableId, lExecuteOptions As Long, pParameters, [lcid As Long], [pInformation])
Параметры
ConnectionString
Строка, используемая для подключения к поставщику OLE DB, где запрос будет отправлен для выполнения. Если обработчик указан с помощью HandlerString он может изменить или заменить строку подключения.
HandlerString
Двухпартийная строка, идентифицирующая обработчик, который будет использоваться с этим выполнением. Строка содержит две части. Первая часть содержит имя (ProgID) используемого обработчика. Вторая часть содержит аргументы, передаваемые обработчику. Сведения о интерпретации строки аргументов зависят от каждого обработчика. Две части разделяются первым экземпляром запятой в строке. Строка аргументов может содержать дополнительные запятые. Аргументы являются необязательными.
QueryString
Команда на языке команд, поддерживаемом поставщиком OLE DB, определяемой в строке подключения. Для поставщиков на основе SQL QueryString может содержать инструкцию команды Transact-SQL, но для поставщиков, отличных от SQL (например, MSDataShape), это может не быть оператором запроса Transact-SQL.
Если используется обработчик, обработчик может изменить или заменить указанное здесь значение. Например, обработчик обычно заменяет QueryString строкой запроса из файла .ini. По умолчанию используется файл Msdfmap.ini.
lFetchOptions
Указывает тип асинхронной выборки.
Дополнительные сведения см. в свойстве FetchOptions (RDS).
TableID
Variant типа VT_EMPTY или VT_BSTR. Если это значение имеет тип VT_EMPTY, он игнорируется. Если он имеет тип VT_BSTR, набор записей создается с помощью adCmdTableDirect, а значение, указанное здесь, и параметр QueryString игнорируется.
lExecuteOptions
Битовая маска параметров выполнения:
1=ReadOnly Набор записей будет открыт с помощью adLockReadOnly.
2=NoBatch Набор записей будет открыт с помощью adLockOptimistic.
4=AllParamInfoSupplied Вызывающий объект гарантирует, что сведения о параметрах для всех параметров предоставляются в pParameters.
8=Сведения о параметрах GetInfo для запроса будут получены от поставщика OLE DB и возвращаются в параметре pParameters. Запрос не выполняется, и набор записей не возвращается.
16=GetHiddenColumns Набор записей будет открыт с помощью adLockBatchOptimistic, а все скрытые столбцы будут включены в набор записей.
ReadOnly, NoBatch и GetHiddenColumns являются взаимоисключающими вариантами; однако он не создает ошибку для задания нескольких из них. Если задано несколько параметров, GetHiddenColumns имеет приоритет над всеми остальными, а затем ReadOnly. Если параметры не указаны, по умолчанию набор записей открывается с помощью adLockBatchOptimistic и скрытые столбцы не включаются в набор записей.
pParameters
Variant, содержащий безопасный массив определений параметров. Если параметр GetInfo был указан в lExecuteOptions, этот параметр используется для возврата определений параметров, полученных от поставщика OLE DB. В противном случае этот параметр может быть пустым.
LCID, используемый для создания ошибок, возвращаемых в pInformation.
pInformation
Указатель на ошибку сведений, возвращаемую execute. Если значение NULL, данные об ошибке не возвращаются.
Замечания
Параметр HandlerString может иметь значение NULL. Что происходит в этом случае, зависит от того, как настроен сервер RDS. Строка обработчика MSDFMAP.handler указывает, что следует использовать предоставленный корпорацией Майкрософт обработчик (Msdfmap.dll). Строка обработчика "MASDFMAP.handler,sample.ini" указывает, что обработчик Msdfmap.dll должен использоваться и что аргумент "sample.ini" должен передаваться обработчику. MSDFMAP.dll интерпретирует аргумент как направление использования sample.ini для проверки строк подключения и запроса.