SqlConnection.ChangeDatabase(String) Metódus

Definíció

Névtér:

System.Data.SqlClient

Szerelvény:

System.Data.dll

Egy megnyitott SqlConnectionadatbázis aktuális adatbázisának módosítása.

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)

Paraméterek

database

String

Az aktuális adatbázis helyett használni kívánt adatbázis neve.

Kivételek

ArgumentException

Az adatbázis neve érvénytelen.

InvalidOperationException

A kapcsolat nincs megnyitva.

SqlException

Az adatbázis nem módosítható.

Példák

Az alábbi példa létrehoz és SqlConnection megjelenít néhány írásvédett tulajdonságot.

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

Megjegyzések

A paraméterben database megadott értéknek érvényes adatbázisnévnek kell lennie. A database paraméter nem tartalmazhat null értéket, üres sztringet vagy csak üres karaktereket tartalmazó karakterláncot.

Lásd még

• Csatlakozás adatforráshoz az ADO-ban.NET
• SQL Server és ADO.NET
• ADO.NET áttekintése