CommandTimeout Property
Collapse the table of content
Expand the table of content

OleDbCommand.CommandTimeout Property

Gets or sets the wait time before terminating an attempt to execute a command and generating an error.

[Visual Basic]
Public Overridable Property CommandTimeout As Integer  Implements _
public virtual int CommandTimeout {get; set;}
public: __property virtual int get_CommandTimeout();
public: __property virtual void set_CommandTimeout(int);
public function get CommandTimeout() : int;
public function set CommandTimeout(int);

Property Value

The time (in seconds) to wait for the command to execute. The default is 30 seconds.




Exception Type Condition
ArgumentException The property value assigned is less than 0.


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


[Visual Basic, C#, C++] The following example creates an OleDbCommand and sets some of its properties.

[Visual Basic] 
Public Sub CreateMyOleDbCommand()
    Dim mySelectQuery As String = "SELECT * FROM Categories ORDER BY CategoryID"
    Dim myCommand As New OleDbCommand(mySelectQuery)
    myCommand.CommandTimeout = 20
End Sub

public void CreateMyOleDbCommand() 
   string mySelectQuery = "SELECT * FROM Categories ORDER BY CategoryID";
   OleDbCommand myCommand = new OleDbCommand(mySelectQuery);
   myCommand.CommandTimeout = 20;

 void CreateMyOleDbCommand()
    String* mySelectQuery = S"SELECT * FROM Categories ORDER BY CategoryID";
    OleDbCommand* myCommand = new OleDbCommand(mySelectQuery);
    myCommand->CommandTimeout = 20;

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

OleDbCommand Class | OleDbCommand Members | System.Data.OleDb Namespace | Connection | CommandText | CommandType | CommandTimeout

© 2016 Microsoft