SqlConnection.ChangeDatabase(String) メソッド

定義

名前空間:

System.Data.SqlClient

アセンブリ:

System.Data.dll

開いている 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)

パラメーター

database

String

現在のデータベースの代わりに使用するデータベースの名前。

例外

ArgumentException

データベース名が正しくありません。

InvalidOperationException

接続が開かれていません。

SqlException

データベースを変更できません。

例

次の例では、 を SqlConnection 作成し、その読み取り専用プロパティの一部を表示します。

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

注釈

パラメーターに database 指定する値は、有効なデータベース名である必要があります。 パラメーターには database 、null 値、空の文字列、または空白文字のみを含む文字列を含めることはできません。

こちらもご覧ください

• ADO.NET のデータ ソースへの接続
• SQL Server と ADO.NET
• ADO.NET の概要