PersonalizationDictionary.Add(String, PersonalizationEntry) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
개인 설정 엔트리를 개인 설정 사전에 추가합니다.
public:
virtual void Add(System::String ^ key, System::Web::UI::WebControls::WebParts::PersonalizationEntry ^ value);public virtual void Add (string key, System.Web.UI.WebControls.WebParts.PersonalizationEntry value);abstract member Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unit
override this.Add : string * System.Web.UI.WebControls.WebParts.PersonalizationEntry -> unitPublic Overridable Sub Add (key As String, value As PersonalizationEntry)매개 변수
- key
- String
상태 정보에 대한 고유한 식별자입니다.
- value
- PersonalizationEntry
개인 설정 사전에 추가할 상태 정보입니다. 이 값은 null일 수 있습니다.
예외
key가 이미 사전에 있어 중복되는 경우
또는
key가 빈 문자열("")이거나 key를 트리밍한 결과가 빈 문자열인 경우
또는
value이(가) PersonalizationEntry가 아닌 경우
설명
이 메서드를 호출 하 고, 다양 한 사용자 지정 상태 정보를 상태 개체에 저장 하 고, 상태 값과 연결 된 범위를 지정할 수 있습니다. WebPartManager컨트롤이 범위 내에 있는 경우 Shared Shared 범위 또는 범위와 연결 된 이름 및 상태 정보를 추가할 수 있습니다 User . 범위에서 User 범위에만 연결 된 이름 및 상태 정보를 추가할 수 있습니다 User .
그러나 Save User 페이지 범위에 관계 없이 또는 범위의 속성을 포함 하 여 모든 속성을 사전에 추가 하는 것이 좋습니다 Shared .
.NET Framework는 해당 하는 경우 범위를 갖는 속성만 저장 합니다 Shared . 즉, WebPart 페이지를 범위 내에 있는 동안 범위에 처음 추가 된 컨트롤을 Shared 나중에 저장 하면 공유 속성이 저장 되지 않습니다 User . 이와 반대로 WebPart 컨트롤이 범위에서 페이지에 추가 User 되 고 나중에 페이지가 범위 내에 있는 동안 컨트롤이 저장 되는 경우 사용자 지정 Shared 공유 속성 값은 사용자 지정 사용자 범위 속성과 함께 저장 됩니다. 개인 설정 데이터에 대 한 자세한 내용 및 공유 및 사용자 범위 속성이 페이지의 개인 설정 범위에 영향을 주는 방식에 대 한 자세한 내용은 웹 파트 개인 설정 개요 항목을 참조 하세요.
모든 컬렉션과 마찬가지로이 메서드는 컬렉션 수를 1 씩 증가 시키고 컬렉션에서 현재 활성화 된 모든 열거자가 무효화 되어야 합니다.