WebPartZone.GetInitialWebParts 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
추상 기본 메서드를 재정의하고 영역의 템플릿에 포함된 정적 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.WebPartCollectionProtected 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 로드할 때 사용자가 끌어오던 두 번째 영역에 실제로 나타납니다.