다음을 통해 공유


LocalFileSettingsProvider.Upgrade 메서드

정의

이전 버전의 동일한 애플리케이션에서 이전 사용자 범위 설정을 마이그레이션합니다.

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 -> unit
Public Sub Upgrade (context As SettingsContext, properties As SettingsPropertyCollection)

매개 변수

context
SettingsContext

현재 애플리케이션의 용도를 설명하는 SettingsContext입니다.

properties
SettingsPropertyCollection

값이 검색될 설정 속성 그룹을 포함하는 SettingsPropertyCollection입니다.

구현

예외

사용자 범위 설정이 발견되었지만 현재 구성이 애플리케이션 범위 설정만 지원하는 경우

또는

이전 버전의 구성 파일에 액세스할 수 없는 경우

설명

LocalFileSettingsProvider 는 별도의 작업에서 로컬 및 로밍 설정을 마이그레이션합니다.

합니다 Upgrade 설정 하는 모든 애플리케이션에 대 한 표시 되지 않는 메서드를 NoSettingsVersionUpgradeAttribute 에서 파생 된 전체 설정 래퍼 클래스를 적용할 ApplicationSettingsBase합니다.

이 메서드는 이러한 방식으로 업그레이드 되는 애플리케이션의 유형에 따라 달라 집니다.

  • ClickOnce 애플리케이션의 각 버전은 자체 격리된 설치 디렉터리에 저장됩니다. ClickOnce 애플리케이션의 새 버전이 설치되고 새 버전이 처음 실행되면 내부 논리가 자동으로 를 호출 Upgrade 하여 모든 일반적인 애플리케이션 설정을 새 버전으로 마이그레이션합니다. 자세한 내용은 ClickOnce 및 애플리케이션 설정을 참조하세요.

  • 표준 Windows Forms 및 콘솔 애플리케이션 호출 수동으로 해야 Upgrade, 이러한 애플리케이션을 처음 실행할 때를 결정 하는 방법을 일반적으로 자동 없기 때문입니다. 확인 하이는 설치 프로그램 또는 유지 된 속성을 사용 하 여 애플리케이션 자체에서 사용 하 여 작업을 수행 하는 두 가지 일반적인 방법 종종 같은 이름의 IsFirstRun합니다.

애플리케이션 설정을 마이그레이션하려면 최신 버전의 경우이 되도록도 로드 하 고 애플리케이션 설정의 이전 버전을 읽을 수 있습니다 note 합니다. 따라서 애플리케이션의 신규 및 이전 버전과 호환 래퍼 클래스 있어야 합니다.

적용 대상

추가 정보