SqlConnection.ChangeDatabase(String) Metode

Referensi

Definisi

Ruang nama:: System.Data.SqlClient

Rakitan:: System.Data.SqlClient.dll

Rakitan:: System.Data.dll

Rakitan:: netstandard.dll, System.Data.SqlClient.dll

Paket:: System.Data.SqlClient v4.8.6

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mengubah database saat ini untuk yang terbuka 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)

Parameter

database: String

Nama database yang akan digunakan alih-alih database saat ini.

Penerapan

ChangeDatabase(String)

Pengecualian

ArgumentException

Nama database tidak valid.

InvalidOperationException

Koneksi tidak terbuka.

SqlException

Tidak dapat mengubah database.

Contoh

Contoh berikut membuat SqlConnection dan menampilkan beberapa properti baca-saja.

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

Keterangan

Nilai yang database disediakan dalam parameter harus berupa nama database yang valid. Parameter database tidak boleh berisi nilai null, string kosong, atau string hanya dengan karakter kosong.

Berlaku untuk