Usando o ADO com o Microsoft Visual Basic e Visual Basic for ApplicationsUsing ADO with Microsoft Visual Basic and Visual Basic for Applications

Configurando um projeto do ADO e escrever código em ADO são semelhante se você usar o Visual Basic ou Visual Basic for Applications.Setting up an ADO project and writing ADO code is similar whether you use Visual Basic or Visual Basic for Applications. Este tópico aborda usando o ADO com o Visual Basic e Visual Basic for Applications e observa as diferenças.This topic addresses using ADO with both Visual Basic and Visual Basic for Applications and notes any differences.

Referência à biblioteca do ADOReferencing the ADO Library

A biblioteca do ADO deve ser referenciada pelo seu projeto.The ADO library must be referenced by your project.

Para fazer referência a ADO do Microsoft Visual BasicTo reference ADO from Microsoft Visual Basic

  1. No Visual Basic, do Project menu, selecione referências... .In Visual Basic, from the Project menu, select References....

  2. Selecione Microsoft ActiveX Data Objects x. x biblioteca na lista.Select Microsoft ActiveX Data Objects x.x Library from the list. Verifique se pelo menos as seguintes bibliotecas também são selecionadas:Verify that at least the following libraries are also selected:

    • Visual Basic for ApplicationsVisual Basic for Applications

    • Procedimentos e objetos de tempo de execução do Visual BasicVisual Basic runtime objects and procedures

    • Procedimentos e objetos do Visual BasicVisual Basic objects and procedures

    • Automação OLEOLE Automation

  3. Clique em OK.Click OK.

Você pode usar ADO facilmente com o Visual Basic para aplicativos, usando o Microsoft Access, por exemplo.You can use ADO just as easily with Visual Basic for Applications, by using Microsoft Access, for example.

Para fazer referência a ADO do Microsoft AccessTo reference ADO from Microsoft Access

  1. No Microsoft Access, selecione ou crie um módulo a partir o módulos guia o banco de dados janela.In Microsoft Access, select or create a module from the Modules tab in the Database window.

  2. Sobre o ferramentas menu, selecione referências... .On the Tools menu, select References....

  3. Selecione Microsoft ActiveX Data Objects x. x biblioteca na lista.Select Microsoft ActiveX Data Objects x.x Library from the list. Verifique se pelo menos as seguintes bibliotecas também são selecionadas:Verify that at least the following libraries are also selected:

    • Visual Basic for ApplicationsVisual Basic for Applications

    • Biblioteca de objetos do Microsoft Access 8.0 (ou posterior)Microsoft Access 8.0 Object Library (or later)

    • Biblioteca de objetos do Microsoft DAO 3.5 (ou posterior)Microsoft DAO 3.5 Object Library (or later)

  4. Clique em OK.Click OK.

Criando objetos do ADO no Visual BasicCreating ADO Objects in Visual Basic

Para criar uma variável de automação e uma instância de um objeto para essa variável, você pode usar dois métodos: Dim ou CreateObject.To create an automation variable and an instance of an object for that variable, you can use two methods: Dim or CreateObject.

DimDim

Você pode usar o New palavra-chave with Dim declarar e criar instâncias de objetos do ADO em uma única etapa:You can use the New keyword with Dim to declare and create instances of ADO objects in one step:

Dim conn As New ADODB.Connection

Como alternativa, o Dim instanciação de declaração e objeto de instrução também pode ser de duas etapas:Alternatively, the Dim statement declaration and object instantiation can also be two steps:

Dim conn As ADODB.Connection
Set conn = New ADODB.Connection

Observação

Não é necessário usar explicitamente o ADODB progid com o Dim instrução, supondo que você referenciou corretamente a biblioteca do ADO em seu projeto.It is not required to explicitly use the ADODB progid with the Dim statement, assuming you have correctly referenced the ADO library in your project. No entanto, usá-lo garante que você não terá conflitos de nomenclatura com outras bibliotecas.However, using it ensures that you will not have naming conflicts with other libraries.

Observação

Por exemplo, se você incluir referências ao ADO e ao DAO no mesmo projeto, você deve incluir um qualificador para especificar qual modelo de objeto a ser usado ao criar uma instância Recordset objetos, como no código a seguir:For example, if you include references to both ADO and DAO in the same project, you should include a qualifier to specify which object model to use when instantiating Recordset objects, as in the following code:

Dim adoRS As ADODB.Recordset
Dim daoRS As DAO.Recordset

CreateObjectCreateObject

Com o CreateObject instanciação de método, a declaração e o objeto deve ser duas etapas distintas:With the CreateObject method, the declaration and object instantiation must be two discrete steps:

Dim conn1
Set conn1 = CreateObject("ADODB.Connection") As Object

Com os objetos instanciados CreateObject são com associação tardia, que significa que eles não são fortemente tipados e preenchimento de linha de comando está desabilitado.Objects instantiated with CreateObject are late-bound, which means that they are not strongly typed and command-line completion is disabled. No entanto, permitir que você ignore a referência à biblioteca do ADO do seu projeto e permite que você crie uma instância versões específicas de objetos.However, it does allow you to skip referencing the ADO library from your project, and enables you to instantiate specific versions of objects. Por exemplo:For example:

Set conn1 = CreateObject("ADODB.Connection.2.0") As Object

Você também pode fazer isso criando especificamente uma referência para a biblioteca do ADO versão 2.0 do tipo e criar o objeto.You could also accomplish this by specifically creating a reference to the ADO version 2.0 type library and creating the object.

Instanciando objetos usando o CreateObject método é geralmente mais lento do que o Dim instrução.Instantiating objects by using the CreateObject method is typically slower than using the Dim statement.

Manipulação de eventosHandling Events

Para tratar eventos ADO no Microsoft Visual Basic, você deve declarar uma variável de nível de módulo usando o WithEvents palavra-chave.In order to handle ADO events in Microsoft Visual Basic, you must declare a module-level variable using the WithEvents keyword. A variável pode ser declarada somente como parte de um módulo de classe e deve ser declarada no nível de módulo.The variable can be declared only as part of a class module and must be declared at the module level. Para obter uma discussão mais completa de manipulação de eventos ADO, consulte manipulação de eventos ADO.For a more thorough discussion of handling ADO events, see Handling ADO Events.

Exemplos do Visual BasicVisual Basic Examples

Muitos exemplos de Visual Basic são incluídos na documentação do ADO.Many Visual Basic examples are included with the ADO documentation. Para obter mais informações, consulte exemplos de código ADO no Microsoft Visual Basic.For more information, see ADO Code Examples in Microsoft Visual Basic.

Consulte tambémSee Also

Microsoft ActiveX Data Objects (ADO) usando o ADO com o Microsoft Visual C++ usando o ADO com linguagens de scriptMicrosoft ActiveX Data Objects (ADO) Using ADO with Microsoft Visual C++ Using ADO with Scripting Languages