LocalFileSettingsProvider.Upgrade 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이전 버전의 동일한 애플리케이션에서 이전 사용자 범위 설정을 마이그레이션하려고 시도합니다.
public:
virtual void Upgrade(System::Configuration::SettingsContext ^ context, System::Configuration::SettingsPropertyCollection ^ properties);public void Upgrade(System.Configuration.SettingsContext context, System.Configuration.SettingsPropertyCollection properties);abstract member Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unit
override this.Upgrade : System.Configuration.SettingsContext * System.Configuration.SettingsPropertyCollection -> unitPublic Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)매개 변수
- context
- SettingsContext
SettingsContext 현재 애플리케이션 사용량을 설명하는 A.
- properties
- SettingsPropertyCollection
SettingsPropertyCollection 값을 검색할 설정 속성 그룹이 들어 있는 항목입니다.
구현
예외
사용자 범위 설정이 발견되었지만 현재 구성은 애플리케이션 범위 설정만 지원합니다.
-또는-
이전 버전의 구성 파일에 액세스할 수 없습니다.
설명
LocalFileSettingsProvider 는 별도의 작업에서 로컬 및 로밍 설정을 마이그레이션합니다.
메서드는 Upgrade 적용된 모든 애플리케이션 설정 NoSettingsVersionUpgradeAttribute 또는 파생된 전체 설정 래퍼 클래스에 ApplicationSettingsBase대해 표시되지 않습니다.
이 메서드가 호출되는 방법은 업그레이드 중인 애플리케이션의 유형에 따라 달라집니다.
ClickOnce 애플리케이션의 각 버전은 자체 격리된 설치 디렉터리에 저장됩니다. ClickOnce 애플리케이션의 새 버전이 설치되고 새 버전이 처음 실행되면 내부 논리가 자동으로 호출 Upgrade 되어 모든 일반 애플리케이션 설정을 새 버전으로 마이그레이션합니다. 자세한 내용은 ClickOnce 및 애플리케이션 설정을 참조하세요.
표준 Windows Forms 및 콘솔 애플리케이션은 이러한 애플리케이션이 처음 실행되는 시기를 결정하는 일반적인 자동 방법이 없기 때문에 Upgrade 수동으로 호출해야 합니다. 이 작업을 수행하는 두 가지 일반적인 방법은 설치 프로그램에서 사용하거나 애플리케이션 자체에서 지속형 속성을 사용하는 것입니다
IsFirstRun.
최신 버전이 애플리케이션 설정을 마이그레이션하려면 이전 버전의 애플리케이션 설정을 로드하고 읽을 수도 있어야 합니다. 따라서 애플리케이션의 새 버전과 이전 버전 모두와 호환되는 래퍼 클래스를 포함해야 합니다.