Aracılığıyla paylaş

WebPartPersonalization.Load Yöntem

  • Başvuru

Tanım

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

Kişiselleştirmeyi başlatır.

protected:
 virtual System::Web::UI::WebControls::WebParts::PersonalizationScope Load();
protected virtual System.Web.UI.WebControls.WebParts.PersonalizationScope Load ();
abstract member Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
override this.Load : unit -> System.Web.UI.WebControls.WebParts.PersonalizationScope
Protected Overridable Function Load () As PersonalizationScope

Döndürülenler

PersonalizationScope

PersonalizationScope Üst WebPartManageröğesi için bir örnek.

Özel durumlar

InvalidOperationException

Kişiselleştirme etkinleştirilmediğinde (Enabled eşittir) bu yöntem çağrılır false.

-veya-

İlişkili WebPartManager özelliğinin Page değeri şeklindedirnull.

-veya-

Denetimin Request ilişkili Page örneğindeki özelliğinin WebPartManager değeri şeklindedirnull.

ProviderException

Sağlayıcı, sayfa işaretlemesinde veya özelliğinde ProviderName açıkça ayarlandı ve sağlayıcı bulunamadı.

-veya-

Kişiselleştirme durumu verilerini içeren nesne: null.

ArgumentException

Veriler yüklenirken ve seri durumdan çıkarılırken bir sorun oluştu.

-veya-

Yapılandırma dosyasındaki bir kişiselleştirme sağlayıcısının tanımında bir hata oluştu.

ConfigurationErrorsException

Varsayılan sağlayıcı bulunamadığından veya kişiselleştirme sağlayıcısı başlatılmaya çalışılırken bir hata oluştuğundan temel alınan kişiselleştirme sağlayıcıları başlatılamadı.

Açıklamalar

Bu, üst WebPartManager denetim adına kişiselleştirme bilgilerini başlatmak için ana giriş noktasıdır. Bu yöntem, üst WebPartManager denetimin yöntemi sırasında çağrılır OnInit . Normalde, üst WebPartManager denetimde kişiselleştirme devre dışı bırakıldıysa, bu yöntem hiçbir zaman çağrılmayacak.

Bu yöntem sırasında aşağıdaki başlatmalar gerçekleşir:

  • Varsayılan kişiselleştirme sağlayıcısına veya sayfa işaretlemesinde veya özelliğinde WebPartManager belirtilen özel sağlayıcıya ProviderName başvuru alınır.

  • Sağlayıcı, o anda yürütülen kullanıcının kullanıcı özelliklerini (DetermineUserCapabilities) belirlemek için çağrılır.

  • Geçerli sayfa/kullanıcı/kapsam bileşiminin kişiselleştirme durumu, sağlayıcı ()LoadPersonalizationState tarafından temel alınan veri deposundan yüklenir ve örnekte depolanır WebPartPersonalization .

  • Geçerli sayfa/kullanıcı/kapsam için kişiselleştirme kapsamı sağlayıcı (DetermineInitialScope tarafından belirlenir. Bu belirlemenin sonucunun özelliğin değerinden InitialScope farklı olabileceğini unutmayın.

Bu yöntemden döndürülen kapsam değeri, özelliği için Scope değer olarak kullanılır.

Not

Kişiselleştirmenin InvalidOperationException etkinleştirilmemesi nedeniyle yalnızca yöntem doğrudan çağrıldığında Load bir özel durum oluşur. ASP.NET uygulamasında, yükü gerçekleştirmek için aslında bir iç yardımcı yöntemi çağrılır ve bu yardımcı yöntem, sayfa için kişiselleştirme etkinleştirilmemişse sessizce döndürür.

Şunlara uygulanır

Ayrıca bkz.