SqlConnection.ChangeDatabase(String) Metoda

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

Zmienia bieżącą bazę danych dla otwartej SqlConnectionbazy danych .

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)

Parametry

database

String

Nazwa bazy danych do użycia zamiast bieżącej bazy danych.

Wyjątki

ArgumentException

Nazwa bazy danych jest nieprawidłowa.

InvalidOperationException

Połączenie nie jest otwarte.

SqlException

Nie można zmienić bazy danych.

Przykłady

Poniższy przykład tworzy obiekt SqlConnection i wyświetla niektóre z jego właściwości tylko do odczytu.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        ChangeSqlDatabase(s);
        Console.ReadLine();
    }

    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);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Uwagi

Wartość podana w parametrze database musi być prawidłową nazwą bazy danych. Parametr database nie może zawierać wartości null, pustego ciągu ani ciągu zawierającego tylko puste znaki.