IPersistComponentSettings.SettingsKey 속성

정의

네임스페이스:

System.Configuration

어셈블리:

System.Configuration.ConfigurationManager.dll

패키지:

System.Configuration.ConfigurationManager v8.0.0

Source:

IPersistComponentSettings.cs

컨트롤의 현재 인스턴스에 대한 애플리케이션 설정 키의 값을 가져오거나 설정합니다.

public:
 property System::String ^ SettingsKey { System::String ^ get(); void set(System::String ^ value); };

public string SettingsKey { get; set; }

member this.SettingsKey : string with get, set

Public Property SettingsKey As String

속성 값

String

컨트롤의 현재 인스턴스에 대한 설정 키를 포함하는 String입니다.

설명

사용 된 SettingsKey 동일한 래퍼 클래스의 인스턴스가 여러 개 있는 경우 애플리케이션 설정 속성 그룹을 구분 하는 속성입니다. 예를 들어, 일반적으로 동일한 애플리케이션에서 동일한 컨트롤의 여러 인스턴스를 배치 하는 다음 컨트롤을 연결 된 래퍼 클래스를 포함 하는 경우 래퍼 클래스의 인스턴스가 여러 개에서 발생 합니다. 설정 키는 구성 데이터가 instance 기준으로 다른 경우에만 필요합니다(예: 동적으로 배치된 컨트롤의 위치).

다음 일반 규칙은 의 SettingsKey사용에 적용됩니다.

• 모든 클래스와 마찬가지로 컨트롤 0 개 이상의 애플리케이션 설정 클래스를 포함할 수 있습니다에서 파생 된 ApplicationSettingsBase합니다. 각 설정 클래스에는 해당 클래스의 여러 인스턴스를 구분하는 데 도움이 되는 자체 ApplicationSettingsBase.SettingsKey 속성이 포함되어 있습니다.

• 컨트롤은 instance별 데이터와 공유 데이터를 다른 설정 클래스로 구분해야 합니다.

• instance 구성 데이터가 get 있는 컨트롤의 경우 속성의 SettingsKey 접근자가 기본적으로 Name 컨트롤의 입니다. 대부분의 경우 컨트롤의 이름을 애플리케이션 내에서 고유 됩니다. 컨트롤에 공유 구성 데이터 get 만 포함된 경우 는 기본적으로 입니다 null.

• 이 속성의 set 접근자를 구현하여 instance별 및 공유 구성 데이터를 포함하는 설정 클래스를 구분해야 합니다. instance별 데이터를 set 포함하는 각 설정 클래스에 대해 는 설정 클래스의 속성으로 ApplicationSettingsBase.SettingsKey 전달하면 됩니다. 공유 데이터를 포함하는 설정 클래스의 경우 는 set 해당 설정 클래스에 대해 아무 작업도 수행하지 않아야 합니다.

추가 정보

• SaveComponentSettings()
• SettingsKey
• 사용자 지정 컨트롤에 대한 애플리케이션 설정