OracleConnection.ChangeDatabase(String) Method

Reference

Definition

Namespace:: System.Data.OracleClient

Assembly:: System.Data.OracleClient.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Changes the current database for an open OracleConnection.

public:
 override void ChangeDatabase(System::String ^ value);

public override void ChangeDatabase (string value);

override this.ChangeDatabase : string -> unit

Public Overrides Sub ChangeDatabase (value As String)

Parameters

value: String

The name of the database to use instead of the current database.

Exceptions

ArgumentException

The database name is not valid.

InvalidOperationException

The connection is not open.

OracleException

Cannot change the database.

Remarks

The value parameter must contain a valid database name, and cannot contain a null value, an empty string (""), or a string with only blank characters.

Note

Unlike the Connection object in the other .NET Framework data providers (SQL Server, OLE DB, and ODBC), OracleConnection does not support a ConnectionTimeout property. Setting a connection time-out either as a property or in the connection string has no effect, and the value returned is always zero. OracleConnection also does not support a Database property or a ChangeDatabase method.

Applies to