Connection.Cancel method (DAO) (Método Connection.Cancel [DAO])

Aplica-se ao: Access 2013, Office 2013

Sintaxe

expressão . Cancelar

expressão Uma variável que representa um objeto Connection.

Comentários

Utilize o método Cancelar para terminar a execução de uma chamada de método Assíncrona Execute ou OpenConnection (ou seja, o método foi invocado com a opção dbRunAsync). Cancelar devolverá um erro de tempo de execução se dbRunAsync não tiver sido utilizado no método que está a tentar terminar.

Ocorrerá um erro se, após uma chamada do método Cancel, você tentar fazer referência ao objeto que tiver sido criado por uma chamada assíncrona de OpenConnection (ou seja, o objeto Connection a partir do qual você chamou o método Cancel).

Exemplo

Este exemplo usa o método StillExecuting e o método Cancel para abrir, de forma assíncrona, um objeto Connection.

    Sub CancelConnectionX() 
     
     Dim wrkMain As Workspace 
     Dim conMain As Connection 
     Dim sngTime As Single 
     
     Set wrkMain = CreateWorkspace("ODBCWorkspace", _ 
     "admin", "", dbUseODBC) 
     ' Open the connection asynchronously. 
     
     ' Note: The DSN referenced below must be configured to 
     ' use Microsoft Windows NT Authentication Mode to 
     ' authorize user access to the Microsoft SQL Server. 
     Set conMain = wrkMain.OpenConnection("Publishers", _ 
     dbDriverNoPrompt + dbRunAsync, False, _ 
     "ODBC;DATABASE=pubs;DSN=Publishers") 
     
     sngTime = Timer 
     
     ' Wait five seconds. 
     Do While Timer - sngTime < 5 
     Loop 
     
     ' If the connection has not been made, ask the user 
     ' if she wants to keep waiting. If she does not, cancel 
     ' the connection and exit the procedure. 
     Do While conMain.StillExecuting 
     
     If MsgBox("No connection yet--keep waiting?", _ 
     vbYesNo) = vbNo Then 
     conMain.Cancel 
     MsgBox "Connection cancelled!" 
     wrkMain.Close 
     Exit Sub 
     End If 
     
     Loop 
     
     With conMain 
     ' Use the Connection object conMain. 
     .Close 
     End With 
     
     wrkMain.Close 
     
    End Sub