ISSCEEngine.UpgradeDatabase(SQL Server Compact)
ISSCEEngine.Upgrade 메서드는 SQL Server Compact 데이터베이스를 버전 3.5에서 버전 4.0로 업그레이드합니다. 원본 데이터베이스가 암호화된 경우 업그레이드된 데이터베이스도 암호화됩니다. 대상 문자열에 암호를 명시적으로 제공하지 않으면 업그레이드된 데이터베이스가 암호화되지 않습니다.
구문
object.UpgradeDatabase(SourceConnection, DestConnection)
매개 변수
매개 변수 |
설명 |
|---|---|
SourceConnection |
원본 데이터베이스(업그레이드할 데이터베이스)에 대한 연결을 지정하는 문자열 값입니다. SourceConnection에서 지정한 데이터베이스가 이미 열려 있으면 오류가 발생합니다. |
DestConnection(선택 사항) |
같은 이름을 사용하는 다른 파일이 있는 경우 대상 데이터베이스에 대한 연결을 지정하는 문자열 값입니다. DestConnection이 널로 전달되는 경우 LCID 및 Password와 같은 필수 속성이 원본 파일에서 파생됩니다. |
반환 값
반환 형식은 HRESULT이며 성공하면 S_OK가 반환됩니다.
프로토타입
HRESULT UpgradeDatabase(BSTR SourceConnection, BSTR DestConnection);
새 파일을 만들지 않고 데이터베이스 파일을 SQL Server Compact 버전 3.1에서 버전 3.5로 업그레이드하려면 원본 및 대상 연결 문자열에 같은 데이터 원본 속성을 전달하십시오.
주의
SourceConnection과 DestConnection 매개 변수는 원본 및 대상 데이터베이스의 속성을 지정합니다. 다음 표에서는 각 매개 변수에 지정할 수 있는 연결 속성을 나열합니다. 다른 연결 속성은 모두 무시됩니다.
속성 |
설명 |
|---|---|
Data Source |
데이터베이스의 이름을 나타냅니다. 이 속성은 원본 및 대상 연결 정보에 모두 필요합니다. |
Locale Identifier |
새 데이터베이스의 LCID(로캘 ID)를 나타냅니다. 이 속성을 생략하면 대상 데이터베이스의 LCID가 시스템 로캘과 동일하게 설정됩니다. LCID는 데이터베이스의 문자열 비교에 적용할 정렬 순서를 지정합니다. |
SSCE:Database Password |
암호로 보호된 데이터베이스의 암호를 나타냅니다. 원본 데이터베이스에 암호가 있으면 해당 암호를 입력해야 합니다. DestConnection 문자열에서 이 매개 변수를 생략하면 새 데이터베이스에 원본 데이터베이스의 암호가 사용됩니다. 대상 데이터베이스에 암호를 설정하지 않으려면 데이터베이스 암호를 빈 문자열로 설정해야 합니다. 데이터베이스 암호의 최대 길이는 40자입니다. |
SSCE:Temp File Directory |
임시 데이터베이스의 위치를 지정합니다. DestConnection 문자열에서 이 매개 변수를 생략하면 현재 데이터베이스 위치가 임시 데이터베이스의 위치로 사용됩니다. |
SSCE:Encryption Mode |
대상 암호화 모드를 지정합니다. 지정되지 않은 경우 Platform Default가 사용됩니다. |
SSCE:Case Sensitive |
데이터베이스가 대/소문자를 구분하는지 여부를 지정합니다. 대/소문자 구분을 사용하려면 true로 설정하고 사용하지 않으려면 false로 설정합니다. 값을 지정하지 않으면 false가 기본값으로 사용됩니다. .gif "참고") 참고
이 연결 속성은 SQL Server Compact SP1에서 도입되었습니다.
|
고유한 LCID 값 목록을 보려면 지원되는 데이터 정렬(SQL Server Compact)을 참조하십시오. 데이터베이스를 만들 응용 프로그램에서 해당 로캘이 지원되는지 확인하십시오.
다른 유효한 암호화 모드 목록은 이전 버전에서 업그레이드(SQL Server Compact)를 참조하십시오.