WebPartZone.GetInitialWebParts Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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.WebPartCollectionProtected Friend Overrides Function GetInitialWebParts () As WebPartCollectionDöndürülenler
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.
