SqlCeConnection.ChangeDatabase 메서드

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

네임스페이스:  System.Data.SqlServerCe
어셈블리:  System.Data.SqlServerCe(System.Data.SqlServerCe.dll)

구문

‘선언
Public Overrides Sub ChangeDatabase ( _
    value As String _
)
‘사용 방법
Dim instance As SqlCeConnection
Dim value As String

instance.ChangeDatabase(value)
public override void ChangeDatabase(
    string value
)
public:
virtual void ChangeDatabase(
    String^ value
) override
abstract ChangeDatabase : 
        value:string -> unit 
override ChangeDatabase : 
        value:string -> unit 
public override function ChangeDatabase(
    value : String
)

매개 변수

  • value
    유형: System.String
    데이터베이스 이름입니다.

구현

IDbConnection.ChangeDatabase(String)

예외

예외 조건
ArgumentException

데이터베이스 이름이 잘못된 경우

InvalidOperationException

연결이 열려 있지 않은 경우

SqlCeException

데이터베이스를 변경할 수 없는 경우

주의

value 매개 변수에 제공된 이름은 유효한 데이터베이스 이름이어야 합니다. 이름은 "\my app\myDB.sdf"와 같이 데이터베이스의 전체 경로여야 합니다. value 매개 변수는 nullnull 참조(Visual Basic에서는 Nothing)이거나 비어 있을 수 없으며 공백 문자만으로 구성된 문자열을 포함할 수 없습니다.

ChangeDatabase는 현재 데이터베이스를 여는 데 사용한 속성과 동일한 속성을 새 데이터베이스에 적용합니다. 그러나 암호는 빈 문자열로 설정됩니다.

새 데이터베이스에서 암호를 요구하면 이 호출은 실패합니다. 이러한 상황이 발생하면 데이터베이스를 변경하기 위해 원래 연결을 닫고 새 연결 문자열을 지정한 다음 연결을 다시 열여야 합니다.

다음 예제에서는 원래 연결 옵션을 유지하면서 데이터베이스를 전환하는 방법을 보여 줍니다.

Dim conn As New SqlCeConnection()

' Set some connection string properties e.g.:
' 
conn.ConnectionString = _
    "Persist Security Info = False; Data Source = 'SalesData.sdf';" & _
    "Password = '<password>'; File Mode = 'shared read'; " & _
    "Max Database Size = 256; Max Buffer Size = 1024"

conn.Open()

' You can change the database while preserving 
' the orignal connection options
'
conn.ChangeDatabase("SupportData.sdf")
SqlCeConnection conn = new SqlCeConnection();

// Set some connection string properties e.g.:
// 
conn.ConnectionString = 
    "Persist Security Info = False; Data Source = 'SalesData.sdf';" +
    "Password = '<password>'; File Mode = 'shared read'; " +
    "Max Database Size = 256; Max Buffer Size = 1024";

conn.Open();

// You can change the database while preserving 
// the orignal connection options
//
conn.ChangeDatabase("SupportData.sdf");

참고 항목

참조

SqlCeConnection 클래스

System.Data.SqlServerCe 네임스페이스