SqlConnection.ChangeDatabase(String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
更改已打开的 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
要代替当前数据库加以使用的数据库的名称。
实现
例外
数据库名称无效。
连接未打开。
不能更改数据库。
示例
以下示例创建 并 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
不能包含空值、空字符串或仅包含空字符的字符串。