Aracılığıyla paylaş

WebPartZone.GetInitialWebParts Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.UI.WebControls.WebParts
Bütünleştirilmiş Kod:
System.Web.dll

Soyut temel yöntemi geçersiz kılar ve bölgenin şablonunda yer alan ilk statik WebPart denetim kümesini alır.

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

Döndürülenler

WebPartCollection

WebPartCollection Bölgenin şablonunda yer WebPart alan tüm veya diğer sunucu denetimlerini içeren bir.

Açıklamalar

yöntemi soyut GetInitialWebParts temel GetInitialWebParts yönteminin bir uygulamasını sağlar. Temel yöntem hiçbir uygulama sağlamaz, ancak türetilmiş sınıfların kişiselleştirme değişikliklerini hesaba katmadan bir bölgeye ait ilk denetim kümesini nasıl alacaklarını özelleştirebilmesi için yöntemini bildirir.

Bölgede CreateWebPart bulunan her sunucu denetimi için yöntemi çağrılır. Bir denetim doğrudan sınıfından WebPart devralıyorsa, yalnızca bölgenin WebParts koleksiyonuna (ve denetimin benzer koleksiyonuna WebPartManager ) eklenir. Bir denetim doğrudan öğesinden WebPartdevralmazsa, Web Bölümleri denetim kümesi denetimi bir GenericWebPart nesneyle sarmalar ve bu da denetimin çalışma zamanında denetim WebPart olarak davranmasını sağlar.

sınıfı, WebPartZone web bölümleri sayfasının işaretlemesindeki bir etiket kümesi içinde statik olarak bildirilen denetim kümesini <zonetemplate> (varsa) döndürerek temel yöntemi uygular. Bir PlaceHolder denetim bir bölgede bildirilirse, denetimin kendisi yerine bu denetimin alt denetimleri eklenir. Bu uygulama, örneğin ana sayfada bir WebPartZone bölge oluşturmanıza ve ardından içerik sayfasında tek tek WebPart veya sunucu denetimleri bildirmenize olanak tanır. Bir WebPartZone bölgede denetimler bildirirsenizLiteral, bunlar yoksayılır.

Not

yöntemi tarafından GetInitialWebParts döndürülen ilk denetim koleksiyonu, kişiselleştirme gerçekleştikten sonra bir bölgedeki denetimlerin gerçek çalışma zamanı koleksiyonundan farklı olabilir. Örneğin, iki WebPartZone denetime sahip bir Web sayfanız olduğunu ve ilkinin etiket içinde statik olarak bildirilen adlı User1 kullanıcı denetimini içerdiğini <zonetemplate> varsayalım. Kullanıcı sayfayı yükler ve ikinci bölgeye sürüklerse User1 , o bölgede User1 bildirildiği için ilk bölge için yöntemini çağırarak GetInitialWebParts döndürülen koleksiyonun bir parçasıdır. Ancak çalışma zamanında, denetim kişiselleştirme verilerini yüklediğinde WebPartManager , User1 aslında kullanıcının onu sürüklediği ikinci bölgede görünür.

Şunlara uygulanır

Ayrıca bkz.