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 경우 범위 또는 Shared 범위와 연결된 User 이름 및 상태 정보를 추가할 수 있습니다. 범위에서 User 범위와만 User 연결된 이름 및 상태 정보를 추가할 수 있습니다.

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

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

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

적용 대상

추가 정보