IPersistComponentSettings.SettingsKey 속성

정의

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

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입니다.

설명

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

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

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

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

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

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

적용 대상

추가 정보