다음을 통해 공유


ClientSettingsProvider 클래스

정의

Windows 기반 애플리케이션이 웹 설정 서비스에서 사용자 설정을 검색할 수 있도록 합니다.

public ref class ClientSettingsProvider : System::Configuration::SettingsProvider, System::Configuration::IApplicationSettingsProvider
public class ClientSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider
[System.Security.SecurityCritical]
public class ClientSettingsProvider : System.Configuration.SettingsProvider, System.Configuration.IApplicationSettingsProvider
type ClientSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider
[<System.Security.SecurityCritical>]
type ClientSettingsProvider = class
    inherit SettingsProvider
    interface IApplicationSettingsProvider
Public Class ClientSettingsProvider
Inherits SettingsProvider
Implements IApplicationSettingsProvider
상속
ClientSettingsProvider
특성
구현

예제

다음 예제 코드를 성공적으로 저장 되지 않은 설정의 목록을 표시 하려면이 이벤트를 사용 하는 방법에 설명 합니다.

private void AttachSettingsSavedEventHandler()
{
    ((ClientSettingsProvider)Properties.Settings.Default.Providers
        ["System.Web.ClientServices.Providers.ClientSettingsProvider"])
        .SettingsSaved +=
        new EventHandler<SettingsSavedEventArgs>(Form1_SettingsSaved);
}

private void Form1_SettingsSaved(object sender,
    SettingsSavedEventArgs e)
{
    // If any settings were not saved, display a list of them.
    if (e.FailedSettingsList.Count > 0)
    {
        String failedSettings = String.Join(
            Environment.NewLine,
            e.FailedSettingsList.ToArray());

        String message = String.Format("{0}{1}{1}{2}",
            "The following setting(s) were not saved:",
            Environment.NewLine, failedSettings);

        MessageBox.Show(message, "Unable to save settings",
            MessageBoxButtons.OK, MessageBoxIcon.Warning);
    }
}
Private WithEvents settingsProvider As ClientSettingsProvider = My.Settings _
    .Providers("System.Web.ClientServices.Providers.ClientSettingsProvider")

Private Sub Form1_SettingsSaved(ByVal sender As Object, _
    ByVal e As SettingsSavedEventArgs) _
    Handles settingsProvider.SettingsSaved

    ' If any settings were not saved, display a list of them.
    If e.FailedSettingsList.Count > 0 Then

        Dim failedSettings As String = String.Join( _
            Environment.NewLine, e.FailedSettingsList.ToArray())

        Dim message As String = String.Format("{0}{1}{1}{2}", _
            "The following setting(s) were not saved:", _
            Environment.NewLine, failedSettings)

        MessageBox.Show(message, "Unable to save settings", _
            MessageBoxButtons.OK, MessageBoxIcon.Warning)

    End If

End Sub

설명

클라이언트 애플리케이션 서비스를 사용 하 여 기존 웹 설정 서비스에서 사용자 설정을 사용 하도록 애플리케이션을 구성 하 여 검색할 수는 ClientSettingsProvider 클래스입니다. 파생 된 애플리케이션 설정 클래스를 통해 사용자 설정 및 구성 후 가져올 수 있습니다 ApplicationSettingsBase 사용 하도록 구성 하 고는 ClientSettingsProvider 클래스입니다. Visual Studio를 사용 하 여 생성 하는 Settings 프로젝트에 대 한 클래스 (으로 액세스 Properties.Settings.Default C# 및 My.Settings Visual Basic에서). 애플리케이션 설정에 대한 자세한 내용은 애플리케이션 설정 개요를 참조하세요.

현재를 검색할 수 있습니다 ClientSettingsProvider 를 통해 합니다 ApplicationSettingsBase.Providers 정규화를 사용 하 여 속성 ClientSettingsProvider 클래스 이름을 키로 합니다. 통해 공급자를 검색할 수도 있습니다는 SettingsLoadedEventArgs.Provider 처리 하는 경우 속성은 ApplicationSettingsBase.SettingsLoaded 이벤트입니다.

참고

이 클래스를 포함 한 SecurityCriticalAttribute 클래스의 모든 멤버에 적용 되는 클래스 수준입니다. 직접 실행 호출자 보안 투명 또는 부분적으로 신뢰할 수 있는 경우 런타임 예외가 throw 됩니다. 보안에 중요 형식 및 멤버에 대 한 자세한 내용은 참조 하십시오 보안 투명 코드, 수준 2합니다.

참고

이 클래스는 모든 멤버에 적용 되는 클래스 수준에서 상속 요청을 포함 합니다. SecurityException 파생된 클래스에는 완전 신뢰 권한이 없는 경우 throw 됩니다. 보안 요청에 대 한 자세한 내용은 참조 하세요 링크 요청 하 고 상속 요청합니다.

생성자

ClientSettingsProvider()

ClientSettingsProvider 클래스의 새 인스턴스를 초기화합니다.

속성

ApplicationName

이 속성은 이 클래스에서 사용되지 않습니다.

Description

관리 도구나 다른 UI(사용자 인터페이스)에 표시하기에 적합한 간단하고 이해하기 쉬운 설명을 가져옵니다.

(다음에서 상속됨 ProviderBase)
Name

구성 중 공급자를 참조하는 데 사용되는 이름을 가져옵니다.

(다음에서 상속됨 ProviderBase)
ServiceUri

웹 설정 서비스 위치를 가져오거나 설정합니다.

메서드

Equals(Object)

지정된 개체가 현재 개체와 같은지 확인합니다.

(다음에서 상속됨 Object)
GetHashCode()

기본 해시 함수로 작동합니다.

(다음에서 상속됨 Object)
GetPreviousVersion(SettingsContext, SettingsProperty)

지정된 속성의 이전 버전을 가져옵니다.

GetPropertyMetadata(String)

지정된 웹 설정 서비스에서 검색한 모든 속성의 메타데이터 컬렉션을 가져옵니다.

GetPropertyValues(SettingsContext, SettingsPropertyCollection)

지정된 애플리케이션 인스턴스와 설정 속성 그룹에 대한 설정 속성 값의 컬렉션을 반환합니다.

GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
Initialize(String, NameValueCollection)

공급자를 초기화합니다.

MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
Reset(SettingsContext)

모든 사용자 설정을 기본값으로 다시 설정합니다.

SetPropertyValues(SettingsContext, SettingsPropertyValueCollection)

지정된 속성 설정 그룹의 값을 설정합니다.

ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)
Upgrade(SettingsContext, SettingsPropertyCollection)

이 메서드는 이 클래스에서 사용되지 않습니다.

이벤트

SettingsSaved

설정 공급자가 속성 값을 웹 설정 서비스에 저장한 후 발생합니다.

적용 대상

추가 정보