SqlConnection.ChangeDatabase(String) Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Açık SqlConnectionbir için geçerli veritabanını değiştirir.

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)

Parametreler

database

String

Geçerli veritabanı yerine kullanılacak veritabanının adı.

Özel durumlar

ArgumentException

Veritabanı adı geçerli değil.

InvalidOperationException

Bağlantı açık değil.

SqlException

Veritabanı değiştirilemiyor.

Örnekler

Aşağıdaki örnek, bir SqlConnection oluşturur ve salt okunur özelliklerinden bazılarını görüntüler.

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

Açıklamalar

parametresinde database sağlanan değer geçerli bir veritabanı adı olmalıdır. database parametresi null değer, boş dize veya yalnızca boş karakterler içeren bir dize içeremez.