WebPartPersonalization.Load Yöntem

Tanım

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 Üst WebPartManageröğesi için bir örnek.

Özel durumlar

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.

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.

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.

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ülmekte olan 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.