Объект command (ado)command object (ado)

См. такжеSee Also

Примеры методов Execute, Requery и Clear (Visual Basic) Execute, Requery, and Clear Methods Example (VB) Пример методов Execute, Requery и Clear (VBScript) Execute, Requery, and Clear Methods Example (VBScript) Пример методов Execute, Requery и Clear (Visual c++) Execute, Requery, and Clear Methods Example (VC++) Свойство CommandStream (ADO) CommandStream Property (ADO) Свойство CommandText (ADO) CommandText Property (ADO) коммандтипинум CommandTypeEnum Метод Execute (соединение ADO) Execute Method (ADO Connection) Событие ExecuteComplete (ADO)ExecuteComplete Event (ADO)

Обработка событийHandling Events

Чтобы обеспечить обработку событий ADO в Microsoft Visual Basic, необходимо объявить переменную уровня модуля с помощью ключевого слова WithEvents .In order to handle ADO events in Microsoft Visual Basic, you must declare a module-level variable using the WithEvents keyword. Переменная может быть объявлена только как часть модуля класса и должна быть объявлена на уровне модуля.The variable can be declared only as part of a class module and must be declared at the module level. Более подробное описание обработки событий ADO см. в разделе Обработка событий ADO.For a more thorough discussion of handling ADO events, see Handling ADO Events.

СинтаксисSyntax

ПараметрыParameters

записейrecordsetОбъект Recordset .A Recordset object.

FieldListFieldListНеобязательный элемент.Optional. Одно имя или массив имен или порядковое расположение полей в новой записи.A single name, or an array of names or ordinal positions of the fields in the new record.

ЗначенияValuesНеобязательный элемент.Optional. Одно значение или массив значений для полей в новой записи.A single value, or an array of values for the fields in the new record. Если списокполей является массивом, то значения также должны быть массивом с одинаковым числом членов. в противном случае возникает ошибка.If Fieldlist is an array, Values must also be an array with the same number of members; otherwise, an error occurs. Порядок имен полей должен совпадать с порядком значений полей в каждом массиве.The order of field names must match the order of field values in each array.

СинтаксисSyntax

ПараметрыParameters

SourceSourceНеобязательный элемент.Optional. Значение типа Variant , результатом которого является допустимый объект команды , инструкция SQL, имя таблицы, вызов хранимой процедуры, URL-адрес или имя файла или объекта потока , содержащего сохраняемый набор записей.A Variant that evaluates to a valid Command object, an SQL statement, a table name, a stored procedure call, a URL, or the name of a file or Stream object containing a persistently stored Recordset.

ActiveConnectionActiveConnectionНеобязательный элемент.Optional. Значение типа Variant , результатом которого является допустимое имя переменной объекта соединения или строка , содержащая параметры ConnectionString .Either a Variant that evaluates to a valid Connection object variable name, or a String that contains ConnectionString parameters.

Примеры CursorTypeCursorTypeНеобязательный элемент.Optional. Значение курсортипинум , определяющее тип курсора, который должен использовать поставщик при открытии набора записей.A CursorTypeEnum value that determines the type of cursor that the provider should use when opening the Recordset. Значение по умолчанию — адопенфорвардонли.The default value is adOpenForwardOnly.

LockTypeLockTypeНеобязательный элемент.Optional. Значение локктипинум , определяющее, какой тип блокировки (параллелизм) должен использоваться поставщиком при открытии набора записей.A LockTypeEnum value that determines what type of locking (concurrency) the provider should use when opening the Recordset. Значение по умолчанию — адлоккреадонли.The default value is adLockReadOnly.

ПараметрыOptionsНеобязательный элемент.Optional. Значение типа Long , указывающее, как поставщик должен оценивать Исходный аргумент, если он представляет нечто, отличное от объекта Command , или что набор записей следует восстановить из файла, в котором он был сохранен ранее.A Long value that indicates how the provider should evaluate the Source argument if it represents something other than a Command object, or that the Recordset should be restored from a file where it was previously saved. Может быть одним или несколькими значениями коммандтипинум или ексекутеоптионенум , которые можно сочетать с помощью побитового оператора или.Can be one or more CommandTypeEnum or ExecuteOptionEnum values, which can be combined with a bitwise OR operator.

Примечание

Если вы открываете набор записей из потока , содержащего материализованный набор записей, использование значения ексекутеоптионенум для адасинкфетчнонблоккинг не приведет к результату. выборка будет синхронной и блокирующей.If you open a Recordset from a Stream containing a persisted Recordset, using an ExecuteOptionEnum value of adAsyncFetchNonBlocking will have no effect; the fetch will be synchronous and blocking.

Примечание

Значения ексекутеопененум в адексекутенорекордс или Адексекутестреам не следует использовать с открытым.The ExecuteOpenEnum values of adExecuteNoRecords or adExecuteStream should not be used with Open.

ADOXADOX

Расширения Microsoft объекты данных ActiveX для языка описания данных и системы безопасности (ADOX) являются расширением объектов ADO и модели программирования.Microsoft ActiveX Data Objects Extensions for Data Definition Language and Security (ADOX) is an extension to the ADO objects and programming model. ADOX включает объекты для создания и изменения схем, а также для обеспечения безопасности.ADOX includes objects for schema creation and modification, as well as security. Поскольку это основанный на объектах подход к обработке схем, можно написать код, который будет работать с различными источниками данных независимо от различий в их синтаксисе.Because it is an object-based approach to schema manipulation, you can write code that will work against various data sources regardless of differences in their native syntaxes.

ADOX — это вспомогательная библиотека для основных объектов ADO.ADOX is a companion library to the core ADO objects. Он предоставляет дополнительные объекты для создания, изменения и удаления объектов схемы, таких как таблицы и процедуры.It exposes additional objects for creating, modifying, and deleting schema objects, such as tables and procedures. Он также включает объекты безопасности для обслуживания пользователей и групп и предоставления и отзыва разрешений на объекты.It also includes security objects to maintain users and groups and to grant and revoke permissions on objects.

ПримечанияRemarks

Свойство Recordset возвращает объект Recordset , который предоставляет данные, просматриваемые в форме, отчете, элементе управления «поле со списком» или элементе управления «поле со списком».The Recordset property returns the Recordset object that provides the data being browsed in a form, report, list box control, or combo box control. Например, если форма основана на запросе, то обращение к свойству Recordset эквивалентно клонированию объекта Recordset с использованием того же запроса.If a form is based on a query, for example, referring to the Recordset property is the equivalent of cloning a Recordset object by using the same query. Тем не менее, в отличие от использования свойства рекордсетклоне , изменение записи Current в наборе записей, возвращаемой свойством Recordset формы, также устанавливает текущую запись формы.However, unlike using the RecordsetClone property, changing which record is current in the recordset returned by the form’s Recordset property also sets the current record of the form.

Примечание

Вы не можете привязывать отчеты к наборам записей ADO.You cannot bind reports to ADO recordsets. Необходимо либо использовать DAO, либо другой дамп набора записей ADO для временной таблицы, а затем привязывать отчет к этой временной таблице.You must either use DAO or else dump the ADO recordset to a temporary table, and then bind the report to that temporary table.

Поведение чтения и записи свойства Recordset определяется типом объекта RECORDSET (ADO или DAO) и типом данных (Access или SQL), который хранится в наборе записей, определенном свойством.The read/write behavior of the Recordset property is determined by the type of recordset (ADO or DAO) and the type of data (Access or SQL) contained in the recordset identified by the property.

Следующий пример открывает форму, открывает объект Recordset, а затем связывает форму с набором записей, присвоив свойству Recordset формы только что созданный объект Recordset .The following example opens a form, opens a recordset, and then binds the form to the recordset by setting the form’s Recordset property to the newly created Recordset object.

Используйте свойство Recordset для следующих действий:Use the Recordset property to:

• Используйте методы с объектом Recordset , который не поддерживается напрямую в формах.Use methods with the Recordset object that aren’t directly supported on forms. Например, вы можете использовать свойство Recordset с методами поиска ADO Find или DAO в настраиваемом диалоговом окне для поиска записи.For example, you can use the Recordset property with the ADO Find or DAO Find methods in a custom dialog for finding a record.

• Создание оболочки для транзакции (которая может быть отменена) вокруг набора изменений, влияющих на несколько форм.Wrap a transaction (which can be rolled back) around a set of edits that affect multiple forms.

  Изменение свойства Recordset формы также может привести к изменению свойств RecordSource, RecordsetTypeи рекордлоккс .Changing a form’s Recordset property may also change the RecordSource, RecordsetType, and RecordLocks properties. Кроме того, некоторые свойства, связанные с данными, могут быть переопределены, например свойства Filter, FilterOn, OrderByи OrderByOn .Also, some data-related properties may be overridden, for example, the Filter, FilterOn, OrderBy, and OrderByOn properties.

  Вызов метода Requery объекта Recordset формы (например, ) может привести к тому, что форма станет несвязанной.Calling the Requery method of a form’s recordset (for example, ) can cause the form to become unbound. Чтобы обновить данные в форме, привязанной к набору записей, задайте для свойства RecordSource формы значение собственно: .To refresh the data in a form bound to a recordset, set the RecordSource property of the form to itself: .

• Привяжите несколько форм к общему набору данных.Bind multiple forms to a common data set. Это позволяет синхронизировать несколько форм.This allows synchronization of multiple forms. Пример.For example:

Примечание

Если форма привязана к набору записей, то при использовании команды » Фильтровать по форме » возникает ошибка.When a form is bound to a recordset, an error occurs if you use the Filter by Form command.

Events

Note:  You cannot handle events using VBScript or JScript (only
Visual Basic, Visual C++, and Visual J++ languages can handle events).

Работа со ссылочными типами

//____________________________________________________________________________________________________
Процедура ф_Реквизиты()
  //Открываем соединение
  ado.Open("Driver={Microsoft Access Driver (*.mdb)};Dbq="+ф_ИмяMDB+";Uid=Admin;Pwd=;");
  спр=СоздатьОбъект("Справочник.Товары");
  спр.ВыбратьЭлементы();
  Пока спр.ПолучитьЭлемент() = 1 Цикл
     Запрос="SELECT Код FROM Товары WHERE Код=?;";
     ado.PrepareQuery(Запрос);
    ado.Bind(+спр.Код);
    ado.Execute();
    Если ado.EOF=1 Тогда
        Запрос="INSERT INTO Товары (Код) VALUES (?)"; 
        ado.PrepareQuery(Запрос);
        ado.Bind(+спр.Код);
        ado.Execute();
    КонецЕсли;    
    
      Запрос="UPDATE Товары SET "+
      "Товар=?,Наименование=?"+
      " WHERE Код=?";
      
      ado.PrepareQuery(Запрос);
      
      ado.Bind(спр.ТекущийЭлемент());
      ado.Bind(спр.Наименование);
      ado.Bind(+спр.Код);
    
      ado.Execute();
  КонецЦикла;

//Читаем элементы
     Запрос="SELECT * FROM Товары";
    ado.Execute(Запрос);
    
    Пока ado.EOF= Цикл //Цикл по записям 
        зн=ado.GetField("Код"); Сообщить("Код="+зн+"");
        зн=ado.GetField("Наименование"); Сообщить("Наименование="+зн+"");
        зн=ado.GetFieldAsObject("Товар"); Сообщить("Товар="+зн+"");
        ado.MoveNext(); //Переходим к след. записи 
    КонецЦикла;
  ado.Close(); //Закрываем соединение
КонецПроцедуры

//____________________________________________________________________________________________________
Процедура ф_Реквизиты1()
  //Открываем соединение
  ado.Open("Driver={Microsoft Access Driver (*.mdb)};Dbq="+ф_ИмяMDB+";Uid=Admin;Pwd=;");
  
  //Пишем товары в таблицу
  спр=СоздатьОбъект("Справочник.Товары");
  спр.ВыбратьЭлементы();
  Пока спр.ПолучитьЭлемент() = 1 Цикл
      
      ado.OpenRec("Товары");
      ado.KeyField("Код", +спр.Код); //Ключевое поле
      ado.DataField("Наименование", спр.Наименование);
      ado.DataField("Товар", спр.ТекущийЭлемент());
      ado.SaveRec();
      
  КонецЦикла;

//Читаем элементы
     Запрос="SELECT * FROM Товары";
    ado.Execute(Запрос);
    
    Пока ado.EOF= Цикл //Цикл по записям 
        зн=ado.GetField("Код"); Сообщить("Код="+зн+"");
        зн=ado.GetField("Наименование"); Сообщить("Наименование="+зн+"");
        зн=ado.GetFieldAsObject("Товар"); Сообщить("Товар="+зн+"");
        ado.MoveNext(); //Переходим к след. записи 
    КонецЦикла;
  ado.Close(); //Закрываем соединение
КонецПроцедуры

ActiveX в Internet Explorer

ActiveX для Internet Explorer — это специальный фреймворк, или плагин, предназначенный для детектирования на веб-страницах (серверах) всевозможных программных компонентов, приложений, созданных на различных языках программирования, и организации их функционирования в Интернет Эксплорере.

Управляющие элементы ActiveX имеют определённую схожесть с апплетами платформы Java. Это составные блоки клиент-серверных программ, работающих в браузере Internet Explorer, интерактивных сценариев для воспроизведения анимации и видео.

Актив X — это уникальная технология, оптимизированная только для IE. Установка элемента ActiveX в браузере как таковая не нужна, поскольку он является частью операционной системы Windows. По умолчанию устанавливается вместе с дистрибутивом ОС.

Из этой статьи вы узнаете, как включить ActiveX в Internet Explorer (активировать) и отключить , а также как настроить фильтрацию его элементов (запретить их включение на веб-страницах), как скачать и установить версию плагина Flash, поддерживающего веб-технологию Active-X.

Настройка

Если выполнение элементов осуществляется некорректно (например, браузер заблокировал доверенные ресурсы, запрещены интерактивные блоки, IE отображает уведомление «Пожалуйста, настройте… ActiveX»), необходимо предварительно настроить модуль:

Примечание. По умолчанию в Интернет Эксплорере заданные оптимальные настройки фильтрации.

1. В верхней части IE кликните раздел «Сервис».

2. Кликните пункт «Свойства браузера».

3. Щёлкните вкладку «Безопасность». Нажмите кнопку «Другой».

4. Прокрутите список параметров вниз, до раздела «Элементы ActiveX… ».

5. Для безопасного и корректного запуска элементов выполните такие настройки:

«Автоматические запросы… » — Отключить (для снижения риска вирусной атаки через задействование этой веб-технологии);

«Включить фильтрацию… » — Включить (для выборочного запуска, также в целях безопасности);

«Разрешать… только увтерждённые» — Включить (для активации только на доверенных сайтах);

«Разрешить… которые не использовались» — Отключить (не запускать блоки, которые раньше не использовались);

«Скачивание неподписанных элементов» — Отключить (также, чтобы не активировать сомнительные, потенциально опасные объекты);

«Скачивание подписанных элементов» — Предлагать (отображается запрос на загрузку).

Примечание. В статье рассмотрены только базовые опции. В списке есть и другие параметры для тонкой отстройки функционирования ActiveX.

Внимание! Если вы не уверены в том, что правильно задали параметры, можно сделать сброс настроек. Для этого в строке «На уровень» задайте уровень особых параметров (например, «Высокий») и кликните «Сбросить»

Фильтр элементов ActiveX — блокирует запуск элементов на веб-страницах по заданным в настройках правилам.

Если вы не знаете, как отключить/включить фильтр ActiveX, выполните эту инструкцию:1. В меню перейдите в раздел «Сервис».

2. Кликом мышки установите или уберите «галочку» в строке «Фильтрация… », соответственно для включения или отключения опции.

Если нужно разрешить запуск элементов на текущей вкладке:1. В адресной строке щелчком мышки запустите блок настройки — иконку «знак запрета».

2. В открывшемся окне нажмите «Отключить фильтрацию… ». После обновления страницы, та её часть, которая была заблокирована, отобразится.

Установка апплета Flash для IE

В виду специфики технологии ActiveX для IE в Windows 7 и XP нужно устанавливать версию Flash, адаптированную именного для него.

Делается это так:1. Откройте офсайт — https://get.adobe.com/ru/flashplayer/.

2. Если в первом блоке не отобразилась настроечная панель, клацните ссылку «Нужен проигрыватель… для другого компьютера?».

3. В первой строке установите версию используемой ОС (Windows 7….).

4. Во второй строке в ниспадающем перечне выберите версию — FP Internet Explorer — ActiveX.

5. Кликом мышки снимите галочки в средней колонке «Дополнительные приложения».

6. Клацните «Загрузить».

7. В нижней панели IE щёлкните «Выполнить».

8. Подтвердите запуск: нажмите «Да» в окне «Контроль… ».

Помните, что правильная настройка модуля Актив X снижает риск заражения браузера и всей системы компьютера вирусами, устраняет навязчивые уведомления о невозможности запуска элементов на доверенных веб-ресурсах.

Properties

Возвращаемое значениеReturn Value

Возвращает ссылку на объект объекта Recordset (ADO) .Returns a Recordset Object (ADO) object reference.

ПараметрыParameters

CommandTextCommandTextСтроковое значение, содержащее инструкцию SQL, хранимую процедуру, URL-адрес или определяемый поставщиком текст для выполнения.A String value that contains the SQL statement, stored procedure, a URL, or provider-specific text to execute. При необходимостиможно использовать имена таблиц, но только в том случае, если поставщик поддерживает SQL.Optionally, table names can be used but only if the provider is SQL aware. Например, если используется имя таблицы «Customers», то ADO автоматически добавляет стандартный синтаксис SQL SELECT для формирования и передачи «SELECT * FROM Customers» в качестве Transact-SQLTransact-SQL инструкции поставщику.For example if a table name of «Customers» is used, ADO will automatically prepend the standard SQL Select syntax to form and pass «SELECT * FROM Customers» as a Transact-SQLTransact-SQL statement to the provider.

RecordsAffectedRecordsAffectedНеобязательный элемент.Optional. Длинная переменная, к которой поставщик возвращает количество записей, затронутых операцией.A Long variable to which the provider returns the number of records that the operation affected.

ПараметрыOptionsНеобязательный элемент.Optional. Значение типа Long , указывающее, как поставщик должен оценивать аргумент CommandText.A Long value that indicates how the provider should evaluate the CommandText argument. Может быть битовой маской одного или нескольких значений коммандтипинум или ексекутеоптионенум .Can be a bitmask of one or more CommandTypeEnum or ExecuteOptionEnum values.

Примечание . Используйте значение Ексекутеоптионенум адексекутенорекордс для повышения производительности за счет минимизации внутренней обработки и для приложений, которые вы переносите из Visual Basic 6,0.Note Use the ExecuteOptionEnum value adExecuteNoRecords to improve performance by minimizing internal processing and for applications that you are porting from Visual Basic 6.0.

Не используйте адексекутестреам с методом EXECUTE объекта Connection .Do not use adExecuteStream with the Execute method of a Connection object.

Не используйте значения Коммандтипинум для Адкмдфиле или Адкмдтабледирект с Execute.Do not use the CommandTypeEnum values of adCmdFile or adCmdTableDirect with Execute. Эти значения можно использовать только в качестве параметров с методами методов запроса Open (ADO Recordset) и Requery для набора записей.These values can only be used as options with the Open Method (ADO Recordset) and Requery Method methods of a Recordset.

Выполнение команды в качестве собственного метода объекта соединенияExecute a command as a native method of a Connection object

Чтобы выполнить команду, присвойте команде имя, используя свойство имя объекта команды .To execute a command, give the command a name using the Command object Name property. Задайте для свойства ActiveConnection объекта Command значение Connection.Set the ActiveConnection property of the Command object to the connection. Затем выполните инструкцию, где имя команды используется как метод для объекта соединения , за которым следуют все параметры и объект Recordset , если возвращаются какие-либо строки.Then issue a statement where the command name is used as if it were a method on the Connection object, followed by any parameters, and a Recordset object if any rows are returned. Задайте свойства набора записей , чтобы настроить результирующий набор записей.Set the Recordset properties to customize the resulting Recordset. Пример:For example:

RemarksRemarks

Используйте свойства BOF и EOF , чтобы определить, содержит ли объект набора записей записи или выходят за пределы объекта набора записей при переходе от записи к записи.Use the BOF and EOF properties to determine whether a Recordset object contains records or whether you have gone beyond the limits of a Recordset object when you move from record to record.

Свойство BOF возвращает значение true (-1), если текущая запись находится перед первой записью, и false (0), если текущая запись находится в положении или после первой записи.The BOF property returns True (-1) if the current record position is before the first record and False (0) if the current record position is on or after the first record.

Свойство EOF возвращает значение true , если текущее расположение записи находится после последней записи, и значение false , если текущая запись находится в положении ON или до последней записи.The EOF property returns True if the current record position is after the last record and False if the current record position is on or before the last record.

Если свойство BOF или EOF имеет значение true, текущая запись отсутствует.If either the BOF or EOF property is True, there is no current record.

При открытии объекта Recordset , не содержащего записей, свойства BOF и EOF устанавливаются в значение true (Дополнительные сведения об этом состоянии набора записейсм. в свойстве RecordCount ).If you open a Recordset object containing no records, the BOF and EOF properties are set to True (see the RecordCount property for more information about this state of a Recordset). При открытии объекта набора записей , содержащего хотя бы одну запись, первая запись является текущей, а свойства BOF и EOF — false.When you open a Recordset object that contains at least one record, the first record is the current record and the BOF and EOF properties are False.

Если удалить последнюю оставшуюся запись в объекте Recordset , то свойства BOF и EOF могут остаться ложными , пока вы не попытаетесь изменить расположение текущей записи.If you delete the last remaining record in the Recordset object, the BOF and EOF properties may remain False until you attempt to reposition the current record.

В этой таблице показано, какие методы Move разрешены с различными сочетаниями свойств BOF и EOF .This table shows which Move methods are allowed with different combinations of the BOF and EOF properties.

Разрешение метода Move не гарантирует, что метод сможет успешно обнаружить запись. Это только означает, что вызов указанного метода Move не приведет к ошибке.Allowing a Move method does not guarantee that the method will successfully locate a record; it only means that calling the specified Move method will not generate an error.

В следующей таблице показано, что происходит с параметрами свойства BOF и EOF при вызове различных методов Move , но не удается успешно найти запись.The following table shows what happens to the BOF and EOF property settings when you call various Move methods but are unable to successfully locate a record.

RemarksRemarks

Используйте метод Close , чтобы закрыть соединение, запись, набор записейили объект потока , чтобы освободить все связанные системные ресурсы.Use the Close method to close a Connection, a Record, a Recordset, or a Stream object to free any associated system resources. Закрытие объекта не приводит к его удалению из памяти; можно изменить параметры свойств и открыть его позже.Closing an object does not remove it from memory; you can change its property settings and open it again later. Чтобы полностью исключить объект из памяти, закройте объект и задайте для переменной объекта значение Nothing (в Visual Basic).To completely eliminate an object from memory, close the object and then set the object variable to Nothing (in Visual Basic).

ADOADO

Microsoft объекты данных ActiveX (ADO) позволяет клиентским приложениям получать доступ к данным из различных источников и управлять ими с помощью поставщика OLE DB.Microsoft ActiveX Data Objects (ADO) enable your client applications to access and manipulate data from a variety of sources through an OLE DB provider. Его основные преимущества — простота использования, высокая скорость, нехватка ресурсов памяти и небольшой объем дискового пространства.Its primary benefits are ease of use, high speed, low memory overhead, and a small disk footprint. ADO поддерживает ключевые функции для создания клиентских и серверных и веб-приложений.ADO supports key features for building client/server and Web-based applications.