방법: 애플리케이션 설정 업데이트

아티클
05/04/2023

이 항목에서는 애플리케이션 설정이 유지되기 전에 유효성을 검사하는 방법을 설명합니다.

애플리케이션 설정이 강력한 형식이기 때문에 사용자가 지정된 설정에 잘못된 형식의 데이터를 할당할 수 없다는 점이 어느 정도 보장됩니다. 그러나 사용자가 설정에 허용 가능한 범위 밖의 값을 할당하려고 시도할 수 있습니다(예: 미래의 생년월일 제공). 모든 애플리케이션 설정 클래스의 부모 클래스인 ApplicationSettingsBase은 이러한 경계 확인을 사용하도록 설정하기 위해 4개의 이벤트를 노출합니다. 이러한 이벤트를 처리하면 모든 유효성 검사 코드를 프로젝트 전체에 분산하지 않고 단일 위치에 배치합니다.

다음 표에 설명된 대로 사용할 이벤트는 설정의 유효성을 검사해야 하는 경우에 따라 다릅니다.

이벤트	발생 및 사용
SettingsLoaded	설정 속성 그룹을 초기 로드한 이후에 발생합니다. 이 이벤트를 사용하여 전체 속성 그룹 초기 값을 애플리케이션 내에서 사용하기 전에 유효성을 검사합니다.
SettingChanging	단일 설정 속성의 값이 변경되기 전에 발생합니다. 이 이벤트를 사용하여 단일 속성을 변경하기 전에 유효성을 검사합니다. 해당 작업 및 선택 항목에 관한 즉각적인 피드백을 사용자에게 제공할 수 있습니다.
PropertyChanged	단일 설정 속성의 값이 변경된 후에 발생합니다. 이 이벤트를 사용하여 단일 속성을 변경한 후에 유효성을 검사합니다. 이 이벤트는 시간이 오래 걸리는 비동기 유효성 검사 프로세스가 필요한 경우가 아니면 거의 유효성 검사에 사용되지 않습니다.
SettingsSaving	설정 속성 그룹이 저장되기 전에 발생합니다. 이 이벤트를 사용하여 전체 속성 그룹 값을 디스크에 유지하기 전에 유효성을 검사합니다.

일반적으로 유효성을 검사하기 위해 동일한 애플리케이션 내에서 이러한 모든 이벤트를 사용하지 않습니다. 예를 들어 SettingChanging 이벤트만 처리하여 모든 유효성 검사 요구 사항을 충족할 수 있는 경우가 많습니다.

이벤트 처리기가 잘못된 값을 감지하면 일반적으로 다음 작업 중 하나를 수행합니다.

기본 값과 같이 올바른 것으로 알려진 값을 자동으로 제공합니다.
정보에 대한 서버 코드의 사용자를 다시 쿼리합니다.
SettingChanging 및 SettingsSaving와 같은 연결된 작업 이전에 발생한 이벤트의 경우 CancelEventArgs 인수를 사용하여 작업을 취소합니다.

이벤트를 처리하는 방법에 대한 자세한 내용은 이벤트 처리기 개요를 참조하세요.

다음 프로시저는 SettingChanging 또는 SettingsSaving 이벤트를 사용하여 유효한 생년월일을 테스트하는 방법을 보여 줍니다. 프로시저는 애플리케이션 설정을 이미 만들었다는 가정 하에서 작성되었습니다. 이 예제에서는 DateOfBirth라는 설정에 대한 범위 검사를 수행합니다. 설정을 만드는 방법에 대한 자세한 내용은 방법: 애플리케이션 설정 만들기를 참조하세요.

애플리케이션 설정 개체를 가져오려면

다음 글머리 기호 항목 중 하나를 완료하여 애플리케이션 설정 개체(래퍼 인스턴스)에 대한 참조를 가져옵니다.
- 속성 편집기에서 Visual Studio 애플리케이션 설정 대화 상자를 사용하여 설정을 만든 경우 다음 식을 통해 언어에 대해 생성된 기본 설정 개체를 검색할 수 있습니다.
```
Properties.Settings.Default
```
```
MySettings.Default
```
  또는
- 사용자가 Visual Basic 개발자이며 프로젝트 디자이너를 사용하여 애플리케이션 설정을 만든 경우 My.Settings 개체를 사용하여 설정을 검색할 수 있습니다.
  
  또는
- ApplicationSettingsBase에서 직접 파생하여 설정을 만든 경우 클래스를 수동으로 인스턴스화해야 해야 합니다.
```
MyCustomSettings settings = new MyCustomSettings();
```
```
Dim Settings as New MyCustomSettings()
```

다음 절차는 이 절차에서 마지막 글머리 기호 항목을 완료하여 애플리케이션 설정 개체를 가져왔다는 가정 하에서 작성되었습니다.

설정이 변경될 때 애플리케이션 설정 유효성을 검사하려면

C# 개발자인 경우 양식 또는 컨트롤의 Load 이벤트에서 SettingChanging 이벤트에 대한 이벤트 처리기를 추가합니다.

또는

사용자가 Visual Basic 개발자인 경우 WithEvents 키워드를 사용하여 Settings 변수를 선언해야 합니다.

public void Form1_Load(Object sender, EventArgs e)
{
    settings.SettingChanging += new SettingChangingEventHandler(MyCustomSettings_SettingChanging);
}

Public Sub Form1_Load(sender as Object, e as EventArgs)
    AddHandler settings.SettingChanging, AddressOf MyCustomSettings_SettingChanging
End Sub

이벤트 처리기를 정의하고 내부에 코드를 작성하여 생년월일에 대한 범위 검사를 수행합니다.

private void MyCustomSettings_SettingChanging(Object sender, SettingChangingEventArgs e)
{
    if (e.SettingName.Equals("DateOfBirth"))
    {
        var newDate = (DateTime)e.NewValue;
        if (newDate > DateTime.Now)
        {
            e.Cancel = true;
            // Inform the user.
        }
    }
}

Private Sub MyCustomSettings_SettingChanging(sender as Object, e as SettingChangingEventArgs) Handles Settings.SettingChanging
    If (e.SettingName.Equals("DateOfBirth")) Then
        Dim NewDate as Date = CType(e.NewValue, Date)
        If (NewDate > Date.Now) Then
            e.Cancel = True
            ' Inform the user.
        End If
    End If
End Sub

저장이 발생할 때 애플리케이션 설정의 유효성을 검사하려면

양식 또는 컨트롤의 Load 이벤트에서 SettingsSaving 이벤트에 대한 이벤트 처리기를 추가합니다.

public void Form1_Load(Object sender, EventArgs e)
{
    settings.SettingsSaving += new SettingsSavingEventHandler(MyCustomSettings_SettingsSaving);
}

Public Sub Form1_Load(Sender as Object, e as EventArgs)
    AddHandler settings.SettingsSaving, AddressOf MyCustomSettings_SettingsSaving
End Sub

이벤트 처리기를 정의하고 내부에 코드를 작성하여 생년월일에 대한 범위 검사를 수행합니다.

private void MyCustomSettings_SettingsSaving(Object sender, SettingsSavingEventArgs e)
{
    if (this["DateOfBirth"] > Date.Now) {
        e.Cancel = true;
    }
}

Private Sub MyCustomSettings_SettingsSaving(Sender as Object, e as SettingsSavingEventArgs)
    If (Me["DateOfBirth"] > Date.Now) Then
        e.Cancel = True
    End If
End Sub

다음을 통해 공유

방법: 애플리케이션 설정 업데이트

애플리케이션 설정 개체를 가져오려면

설정이 변경될 때 애플리케이션 설정 유효성을 검사하려면

저장이 발생할 때 애플리케이션 설정의 유효성을 검사하려면

참고 항목

추가 리소스