SqlConnection.ChangeDatabase(String) 方法

  • 参考

定义

命名空间:
System.Data.SqlClient
程序集:
System.Data.SqlClient.dll
程序集:
System.Data.dll
包:
System.Data.SqlClient v4.8.6

更改已打开的 SqlConnection 的当前数据库。

public:
 override void ChangeDatabase(System::String ^ database);
public:
 virtual void ChangeDatabase(System::String ^ database);
public override void ChangeDatabase (string database);
public void ChangeDatabase (string database);
override this.ChangeDatabase : string -> unit
abstract member ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
Public Overrides Sub ChangeDatabase (database As String)
Public Sub ChangeDatabase (database As String)

参数

database
String

要代替当前数据库加以使用的数据库的名称。

实现

ChangeDatabase(String)

例外

ArgumentException

数据库名称无效。

InvalidOperationException

连接未打开。

SqlException

不能更改数据库。

示例

以下示例创建 并 SqlConnection 显示其一些只读属性。

private static void ChangeSqlDatabase(string connectionString)
{
    // Assumes connectionString represents a valid connection string
    // to the AdventureWorks sample database.
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("Database: {0}", connection.Database);

        connection.ChangeDatabase("Northwind");
        Console.WriteLine("Database: {0}", connection.Database);
    }
}

Private Sub ChangeSqlDatabase(ByVal connectionString As String)
    ' Assumes connectionString represents a valid connection string
    ' to the AdventureWorks sample database.
    Using connection As New SqlConnection(connectionString)

        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("Database: {0}", connection.Database)

        connection.ChangeDatabase("Northwind")
        Console.WriteLine("Database: {0}", connection.Database)
    End Using
End Sub

注解

参数中 database 提供的值必须是有效的数据库名称。 参数 database 不能包含空值、空字符串或仅包含空字符的字符串。

适用于

另请参阅