SqlConnection.ChangeDatabase(String) 方法

定义

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

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

public:
 virtual void ChangeDatabase(System::String ^ database);
public:
 override void ChangeDatabase(System::String ^ database);
public void ChangeDatabase(string database);
public override void ChangeDatabase(string database);
abstract member ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
Public Sub ChangeDatabase (database As String)
Public Overrides 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 参数不能包含空值、空字符串或仅包含空白字符的字符串。

适用于

另请参阅