SqlConnection.ChangeDatabase(String) 方法

定義

命名空間:

System.Data.SqlClient

組件:

System.Data.dll

為開啟的 SqlConnection 變更目前的資料庫。

public:
 override void ChangeDatabase(System::String ^ database);

public override void ChangeDatabase (string database);

override this.ChangeDatabase : string -> unit

Public Overrides Sub ChangeDatabase (database As String)

參數

database

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

另請參閱

• 在 ADO.NET 中聯機到數據源
• SQL Server and ADO.NET (SQL Server 和 ADO.NET)
• ADO.NET 概觀 \(部分機器翻譯\)