This documentation is archived and is not being maintained.

OleDbConnection.ConnectionTimeout Property

Gets the time to wait while trying to establish a connection before terminating the attempt and generating an error.

Namespace:  System.Data.OleDb
Assembly:  System.Data (in System.Data.dll)

'Declaration
Public Overrides ReadOnly Property ConnectionTimeout As Integer
'Usage
Dim instance As OleDbConnection 
Dim value As Integer 

value = instance.ConnectionTimeout

Property Value

Type: System.Int32
The time in seconds to wait for a connection to open. The default value is 15 seconds.

Implements

IDbConnection.ConnectionTimeout
IDbConnection.ConnectionTimeout

ExceptionCondition
ArgumentException

The value set is less than 0.

A value of 0 indicates no limit, and should be avoided in a ConnectionString because an attempt to connect will wait indefinitely.

The following example creates an OleDbConnection and sets some of its properties in the connection string.

' The connectionString argument contains the Connect Timeout  
' keywords, as follows: "... ;Connect Timeout=30;" 
Public Sub InsertRow(ByVal connectionString As String, _
    ByVal insertSQL As String)

    Using connection As New OleDbConnection(connectionString)
        ' The insertSQL string contains a SQL statement that 
        ' inserts a new row in the source table. 
        Dim command As New OleDbCommand(insertSQL)

        ' Set the Connection to the new OleDbConnection.
        command.Connection = connection

        ' Open the connection and execute the insert command. 
        Try
            connection.Open()
            command.ExecuteNonQuery()
        Catch ex As Exception
            Console.WriteLine(ex.Message)
        End Try 
        ' The connection is automatically closed when the 
        ' code exits the Using block. 
    End Using 
End Sub

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Show: