IPersistComponentSettings.SettingsKey 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
컨트롤의 현재 인스턴스에 대한 애플리케이션 설정 키의 값을 가져오거나 설정합니다.
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
해당 설정 클래스에 대해 아무 작업도 수행하지 않아야 합니다.
적용 대상
추가 정보
.NET
피드백
https://aka.ms/ContentUserFeedback을 참조하세요.
출시 예정: 2024년 내내 콘텐츠 피드백 메커니즘인 GitHub 문제를 단계적으로 폐지하고 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은다음에 대한 사용자 의견 제출 및 보기