다음을 통해 공유


WebPartZone.GetInitialWebParts 메서드

정의

추상 기본 메서드를 재정의하고 영역의 템플릿에 포함된 정적 WebPart 컨트롤의 초기 설정을 가져옵니다.

protected public:
 override System::Web::UI::WebControls::WebParts::WebPartCollection ^ GetInitialWebParts();
protected internal override System.Web.UI.WebControls.WebParts.WebPartCollection GetInitialWebParts ();
override this.GetInitialWebParts : unit -> System.Web.UI.WebControls.WebParts.WebPartCollection
Protected Friend Overrides Function GetInitialWebParts () As WebPartCollection

반환

영역의 템플릿에 포함된 모든 WebPartCollection 또는 기타 서버 컨트롤이 들어 있는 WebPart입니다.

설명

메서드는 GetInitialWebParts 추상 기본 GetInitialWebParts 메서드의 구현을 제공합니다. 기본 메서드는 구현을 제공하지 않지만 파생 클래스가 개인 설정 변경 내용을 고려하지 않고 영역에 속하는 초기 컨트롤 집합을 가져오는 방법을 사용자 지정할 수 있도록 메서드를 선언합니다.

영역에 있는 각 서버 컨트롤에 대해 메서드가 CreateWebPart 호출됩니다. 컨트롤이 클래스에서 WebPart 직접 상속되는 경우 단순히 영역의 컬렉션(및 컨트롤의 WebParts 유사한 컬렉션)에 WebPartManager 추가됩니다. 컨트롤이 에서 WebPart직접 상속되지 않는 경우 웹 파트 컨트롤 집합은 컨트롤을 개체로 GenericWebPart 래핑하므로 런타임에 컨트롤이 WebPart 컨트롤로 동작할 수 있습니다.

클래스는 WebPartZone 웹 파트 페이지의 태그 집합 내에서 정적으로 선언된 컨트롤 집합 <zonetemplate> (있는 경우)을 반환하여 기본 메서드를 구현합니다. 컨트롤이 PlaceHolder 영역에 선언된 경우 컨트롤 자체가 아니라 해당 컨트롤의 자식 컨트롤이 추가됩니다. 예를 들어 이 구현을 사용하면 마스터 페이지에서 영역을 만든 WebPartZone 다음 콘텐츠 페이지에서 개별 WebPart 또는 서버 컨트롤을 선언할 수 있습니다. 영역에서 컨트롤을 WebPartZone 선언 Literal 하면 무시됩니다.

참고

메서드에서 반환된 GetInitialWebParts 컨트롤의 초기 컬렉션은 개인 설정이 수행된 후 영역에 있는 컨트롤의 실제 런타임 컬렉션과 다를 수 있습니다. 예를 들어 두 개의 WebPartZone 컨트롤이 있는 웹 페이지가 있고 첫 번째 페이지에는 태그 내에서 정적으로 선언된 라는 User1 사용자 컨트롤이 <zonetemplate> 포함되어 있다고 가정합니다. 사용자가 페이지를 로드하고 두 번째 영역으로 끌어 User1 오면 해당 영역에서 User1 선언되기 때문에 첫 번째 영역에 대한 메서드를 호출 GetInitialWebParts 하여 반환되는 컬렉션의 일부가 됩니다. 그러나 런타임에 컨트롤이 WebPartManager 개인 설정 데이터를 User1 로드할 때 사용자가 끌어오던 두 번째 영역에 실제로 나타납니다.

적용 대상

추가 정보