다음을 통해 공유


SqlConnection.ChangeDatabase(String) 메서드

정의

열려 있는 SqlConnection의 현재 데이터베이스를 변경합니다.

public:
 override void ChangeDatabase(System::String ^ database);
public:
 virtual void ChangeDatabase(System::String ^ database);
public override void ChangeDatabase (string database);
public void ChangeDatabase (string database);
override this.ChangeDatabase : string -> unit
abstract member ChangeDatabase : string -> unit
override this.ChangeDatabase : string -> unit
Public Overrides Sub ChangeDatabase (database As String)
Public Sub ChangeDatabase (database As String)

매개 변수

database
String

현재 데이터베이스 대신 사용할 데이터베이스의 이름입니다.

구현

예외

데이터베이스 이름이 올바르지 않은 경우

연결이 열려 있지 않습니다.

데이터베이스를 변경할 수 없습니다.

예제

다음 예제에서는 을 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 값, 빈 문자열 또는 빈 문자만 있는 문자열을 포함할 수 없습니다.

적용 대상

추가 정보