WebPart.SetPersonalizationDirty 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

WebPartZoneBase 영역에 배치된 서버 컨트롤이나 웹 파트 컨트롤의 개인 설정 데이터가 변경되었음을 나타내는 플래그를 설정합니다.

오버로드

SetPersonalizationDirty(Control)	WebPartZoneBase 영역에 있는 지정된 서버 컨트롤의 개인 설정 데이터가 변경되었음을 나타내는 플래그를 설정합니다.
SetPersonalizationDirty()	현재 WebPart 컨트롤 인스턴스의 개인 설정 데이터가 변경되었음을 나타내는 플래그를 설정합니다.

SetPersonalizationDirty(Control)

WebPartZoneBase 영역에 있는 지정된 서버 컨트롤의 개인 설정 데이터가 변경되었음을 나타내는 플래그를 설정합니다.

public:
 static void SetPersonalizationDirty(System::Web::UI::Control ^ control);

public static void SetPersonalizationDirty (System.Web.UI.Control control);

static member SetPersonalizationDirty : System.Web.UI.Control -> unit

Public Shared Sub SetPersonalizationDirty (control As Control)

매개 변수

control

Control

개인 설정 데이터가 변경된 Control입니다.

예외

ArgumentNullException

control 매개 변수의 개체가 null인 경우

ArgumentException

컨트롤이 페이지와 연결되지 않은 경우

또는

컨트롤이 WebPart에서 파생된 경우. WebPart에서 파생된 컨트롤은 대신 보호되는 SetPersonalizationDirty() 메서드를 사용해야 합니다.

InvalidOperationException

컨트롤과 연결된 페이지에 WebPartManager가 없는 경우

설명

메서드는 WebPart.SetPersonalizationDirty HTTP GET 요청 중에 서버 컨트롤에서 WebPart.SetPersonalizationDirty() 컨트롤 상태 데이터가 변경(개인 설정됨)되었음을 나타내는 플래그를 설정하는 메서드와 동일한 용도로 사용됩니다. 이러한 메서드 간의 차이점은는 WebPart.SetPersonalizationDirty 에서 상속 하지 않는 서버 컨트롤에 대 한 메서드를 사용 합니다 WebPart 클래스 이지만 내에 배치 됩니다 WebPartZoneBase 웹 파트 애플리케이션에 참여.

추가 정보

• ASP.NET 웹 파트 컨트롤

SetPersonalizationDirty()

현재 WebPart 컨트롤 인스턴스의 개인 설정 데이터가 변경되었음을 나타내는 플래그를 설정합니다.

protected:
 void SetPersonalizationDirty();

protected void SetPersonalizationDirty ();

member this.SetPersonalizationDirty : unit -> unit

Protected Sub SetPersonalizationDirty ()

예외

InvalidOperationException

WebPartManager은 null입니다.

설명

SetPersonalizationDirty 메서드는 컨트롤 상태 데이터가 WebPart 컨트롤에서 변경(개인 설정)되었음을 나타내는 플래그를 설정하며, 따라서 WebPartManager 컨트롤은 개인 설정 데이터를 장기 스토리지로 유지해야 합니다.

일반적으로 는 WebPartManager 개발자가 메서드를 호출 SetPersonalizationDirty 할 필요 없이 컨트롤에서 WebPart 개인 설정 변경 내용을 유지합니다. 그러나 개발자가 이 메서드를 호출해야 하는 두 가지 경우가 있습니다. 첫 번째 사례는 페이지에 대한 HTTP GET 요청 중에 컨트롤 상태 데이터가 변경되는 경우입니다. 기본적으로 요청 중 상태 데이터 제어에 대한 GET 변경 내용은 유지되지 않습니다(보안 목적으로). 그러나 메서드는 SetPersonalizationDirty 이 경우 컨트롤에 대한 합법적인 개인 설정 변경을 WebPart 유지하는 방법을 제공합니다.

메서드를 호출하는 SetPersonalizationDirty 두 번째 사례는 페이지에 대한 HTTP POST 요청 중에 발생합니다. 컨트롤에 WebPart 복잡한 개인 설정 가능한 속성(예: 개체를 포함하는 ArrayList 속성)이 있고 해당 속성의 컨트롤 상태 데이터가 요청 중에 POST 개인 설정된 경우 개발자는 메서드를 호출 SetPersonalizationDirty 하여 변경 내용이 유지되도록 해야 합니다.

추가 정보

• ASP.NET 웹 파트 컨트롤