SqlConnection.ChangeDatabase(String) Metoda

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Změní aktuální databázi otevřeného objektu 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)

Parametry

database

String

Název databáze, která se má použít místo aktuální databáze.

Výjimky

ArgumentException

Název databáze není platný.

InvalidOperationException

Připojení není otevřené.

SqlException

Databázi nelze změnit.

Příklady

Následující příklad vytvoří SqlConnection a zobrazí některé jeho vlastnosti jen pro čtení.

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

Poznámky

Hodnota zadaná v parametru database musí být platný název databáze. Parametr database nesmí obsahovat hodnotu null, prázdný řetězec ani řetězec pouze s prázdnými znaky.