SqlConnection::ChangeDatabase Method (String^)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Changes the current database for an open SqlConnection.

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

public:
virtual void ChangeDatabase(
	String^ database
) override

Parameters

database
Type: System::String^

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

Exception Condition
ArgumentException

The database name is not valid.

InvalidOperationException

The connection is not open.

SqlException

Cannot change the database.

The value supplied in the database parameter must be a valid database name. The database parameter cannot contain a null value, an empty string, or a string with only blank characters.

The following example creates a SqlConnection and displays some of its read-only properties.

No code example is currently available or this language may not be supported.

.NET Framework
Available since 1.1
Return to top
Show: