Объект Connection (ADO)Connection Object (ADO)

Представляет открытое подключение к источнику данных.Represents an open connection to a data source.

RemarksRemarks

Объект Connection представляет уникальный сеанс с источником данных.A Connection object represents a unique session with a data source. В системе базы данных клиента или сервера она может быть эквивалентна фактическому сетевому подключению к серверу.In a client/server database system, it may be equivalent to an actual network connection to the server. В зависимости от функциональности, поддерживаемой поставщиком, некоторые коллекции, методы или свойства объекта соединения могут быть недоступны.Depending on the functionality supported by the provider, some collections, methods, or properties of a Connection object may not be available.

С помощью коллекций, методов и свойств объекта Connection можно выполнять следующие действия.With the collections, methods, and properties of a Connection object, you can do the following:

  • Настройте подключение перед его открытием с помощью свойств ConnectionString, ConnectionTimeoutи mode .Configure the connection before opening it with the ConnectionString, ConnectionTimeout, and Mode properties. ConnectionString — это свойство объекта Connection по умолчанию.ConnectionString is the default property of the Connection object.

  • Задайте для свойства CursorLocation значение Client, чтобы вызвать службу Microsoft Cursor для OLE DB, которая поддерживает пакетные обновления.Set the CursorLocation property to client to invoke the Microsoft Cursor Service for OLE DB, which supports batch updates.

  • Задайте для соединения базу данных по умолчанию со свойством DefaultDatabase .Set the default database for the connection with the DefaultDatabase property.

  • Установите уровень изоляции для транзакций, открытых в соединении со свойством IsolationLevel .Set the level of isolation for the transactions opened on the connection with the IsolationLevel property.

  • Укажите поставщик OLE DB с помощью свойства provider .Specify an OLE DB provider with the Provider property.

  • Установите и попозже приостановить физическое подключение к источнику данных с помощью методов Open и Close .Establish, and later break, the physical connection to the data source with the Open and Close methods.

  • Выполните команду в соединении с методом EXECUTE и настройте выполнение с помощью свойства CommandTimeout .Execute a command on the connection with the Execute method and configure the execution with the CommandTimeout property.

    Примечание

    Чтобы выполнить запрос без использования объекта Command, передайте строку запроса в метод EXECUTE объекта Connection .To execute a query without using a Command object, pass a query string to the Execute method of a Connection object. Однако объект команды необходим, если нужно сохранить текст команды и повторно выполнить его, либо использовать параметры запроса.However, a Command object is required when you want to persist the command text and re-execute it, or use query parameters.

  • Управление транзакциями в открытом соединении, включая вложенные транзакции, если поставщик поддерживает их, с помощью методов примеры BeginTrans, CommitTransи RollbackTrans и свойства Attributes .Manage transactions on the open connection, including nested transactions if the provider supports them, with the BeginTrans, CommitTrans, and RollbackTrans methods and the Attributes property.

  • Проверьте ошибки, возвращенные из источника данных с помощью коллекции ошибок .Examine errors returned from the data source with the Errors collection.

  • Считывает версию из реализации ADO, используемой со свойством Version .Read the version from the ADO implementation used with the Version property.

  • Получите сведения о схеме базы данных с помощью метода OpenSchema .Obtain schema information about your database with the OpenSchema method.

Объекты соединения можно создавать независимо от любого другого ранее определенного объекта.You can create Connection objects independently of any other previously defined object.

Можно выполнять именованные команды или хранимые процедуры, как если бы они были собственными методами для объекта соединения , как показано в следующем разделе.You can execute named commands or stored procedures as if they were native methods on a Connection object, as shown in the next section. Если именованная команда имеет то же имя, что и хранимая процедура, то для объекта соединения вызовите "собственный вызов метода" всегда выполните именованную команду вместо процедуры Store.When a named command has the same name as that of a stored procedure, invoke the "native method call" on a Connection object always execute the named command instead of the store procedure.

Примечание

Не используйте эту функцию (вызов именованной команды или хранимой процедуры, как если бы он был собственным методом в объекте Connection ) в приложении Microsoft® .NET Framework, поскольку базовая реализация функции конфликтует с тем, как .NET Framework взаимодействует с COM.Do not use this feature (calling a named command or stored procedure as if it were a native method on the Connection object) in a Microsoft® .NET Framework application, because the underlying implementation of the feature conflicts with the way the .NET Framework interoperates with COM.

Выполнение команды в качестве собственного метода объекта соединения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:

Dim cnn As New ADODB.Connection  
Dim cmd As New ADODB.Command  
Dim rst As New ADODB.Recordset  
...  
cnn.Open "..."  
cmd.Name = "yourCommandName"  
cmd.ActiveConnection = cnn  
...  
'Your command name, any parameters, and an optional Recordset.  
cnn. "parameter", rst  

Выполнение хранимой процедуры в качестве собственного метода объекта соединенияExecute a stored procedure as a native method of a Connection object

Чтобы выполнить хранимую процедуру, выполните инструкцию, где имя хранимой процедуры используется как метод в объекте Connection , за которым следуют все параметры.To execute a stored procedure, issue a statement where the stored procedure name is used as if it were a method on the Connection object, followed by any parameters. ADO выполнит «наилучшее предположение» типов параметров.ADO will make a "best guess" of parameter types. Пример:For example:

Dim cnn As New ADODB.Connection  
...  
'Your stored procedure name and any parameters.  
cnn. "parameter"  

Объект соединения является надежным для сценариев.The Connection object is safe for scripting.

Этот раздел содержит следующий раздел.This section contains the following topic.

См. такжеSee Also

Объект Command (ADO) Command Object (ADO)
Коллекция Errors (ADO) Errors Collection (ADO)
Коллекция Properties (ADO) Properties Collection (ADO)
Объект Recordset (ADO) Recordset Object (ADO)
Приложение А. ПоставщикиAppendix A: Providers