PersonalizationDictionary.Add(String, PersonalizationEntry) 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

개인 설정 엔트리를 개인 설정 사전에 추가합니다.

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 -> unit

Public Overridable Sub Add (key As String, value As PersonalizationEntry)

매개 변수

key

String

상태 정보에 대한 고유한 식별자입니다.

value

PersonalizationEntry

개인 설정 사전에 추가할 상태 정보입니다. 이 값은 null일 수 있습니다.

예외

ArgumentException

key가 이미 사전에 있어 중복되는 경우

또는

key가 빈 문자열("")이거나 key를 트리밍한 결과가 빈 문자열인 경우

또는

value이(가) PersonalizationEntry가 아닌 경우

ArgumentNullException

key이(가) null인 경우

또는

value은 null입니다.

설명

이 메서드를 호출하고, 다양한 사용자 지정 상태 정보를 상태 개체에 배치하고, 상태 값과 연결된 범위를 지정할 수 있습니다. 컨트롤이 WebPartManager 범위에 있는 Shared 경우 범위 또는 User 범위와 연결된 Shared 이름 및 상태 정보를 추가할 수 있습니다. 범위에서 User 범위와만 User 연결된 이름 및 상태 정보를 추가할 수 있습니다.

그러나 페이지의 범위에 관계없이 또는 Shared 범위가 있는 속성을 포함하여 를 사용하여 Save 사전에 모든 속성을 User 추가하는 것이 좋습니다.

.NET Framework는 적절한 경우에만 범위가 있는 Shared 속성을 저장합니다. 즉, 처음에 범위에 추가된 컨트롤이 나중에 페이지가 범위에 있는 Shared 동안 저장되면 공유 속성이 User 저장 WebPart 되지 않습니다. 반대 시나리오에서 컨트롤이 WebPart 범위의 User 페이지에 추가되고 나중에 페이지가 범위에 있는 Shared 동안 컨트롤이 저장되면 사용자 지정 공유 속성 값이 사용자 지정 사용자 범위 속성과 함께 저장됩니다. 개인 설정 데이터 및 공유 및 사용자 범위 속성이 페이지의 개인 설정 범위에 의해 어떻게 영향을 받는지에 대한 자세한 내용은 웹 파트 개인 설정 개요 항목을 참조하세요.

모든 컬렉션과 마찬가지로 이 메서드는 컬렉션 수를 1씩 증가시키고 컬렉션에서 현재 활성 상태인 열거자는 무효화되어야 합니다.

추가 정보

• 웹 파트 개인 설정 개요