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參數不能包含空值、空字串，或只有空白字元的字串。

適用於

另請參閱