Bagikan melalui

WebPartPersonalization.Load Metode

  • Referensi

Definisi

Ruang nama:
System.Web.UI.WebControls.WebParts
Rakitan:
System.Web.dll

Menginisialisasi personalisasi.

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

Mengembalikan

PersonalizationScope

Instans PersonalizationScope untuk induk WebPartManager.

Pengecualian

InvalidOperationException

Metode ini dipanggil ketika personalisasi tidak diaktifkan (Enabled sama dengan false).

-atau-

Nilai Page properti untuk yang terkait WebPartManager adalah null.

-atau-

Nilai Request properti pada WebPartManager instans terkait Page kontrol adalah null.

ProviderException

Penyedia secara eksplisit diatur dalam markup halaman atau ProviderName properti dan penyedia tidak dapat ditemukan.

-atau-

Objek yang berisi data status personalisasi adalah null.

ArgumentException

Terjadi masalah saat memuat dan mendeserialisasi data.

-atau-

Terjadi kesalahan dalam definisi penyedia personalisasi dalam file konfigurasi.

ConfigurationErrorsException

Penyedia personalisasi yang mendasar gagal menginisialisasi karena penyedia default tidak dapat ditemukan atau karena terjadi kegagalan saat mencoba menginisialisasi penyedia personalisasi.

Keterangan

Ini adalah titik masuk utama untuk menginisialisasi informasi personalisasi atas nama kontrol induk WebPartManager . Metode ini dipanggil selama metode kontrol OnInit indukWebPartManager. Biasanya, jika personalisasi telah dinonaktifkan pada kontrol induk WebPartManager , metode ini tidak akan pernah dipanggil.

Selama metode ini, inisialisasi berikut terjadi:

  • Referensi ke penyedia personalisasi default, atau penyedia kustom yang ditunjukkan dalam WebPartManager markup halaman atau ProviderName properti, diperoleh.

  • Penyedia dipanggil untuk menentukan kemampuan pengguna (DetermineUserCapabilities) untuk pengguna yang sedang dijalankan.

  • Status personalisasi untuk kombinasi halaman/pengguna/cakupan saat ini dimuat dari penyimpanan data yang mendasar oleh penyedia (LoadPersonalizationState) dan disimpan dalam WebPartPersonalization instans.

  • Cakupan personalisasi untuk halaman/pengguna/cakupan saat ini ditentukan oleh penyedia (DetermineInitialScope). Perhatikan bahwa hasil penentuan ini mungkin berbeda dari InitialScope nilai properti.

Nilai cakupan yang dikembalikan dari metode ini digunakan sebagai nilai untuk Scope properti .

Catatan

Pengecualian InvalidOperationException karena personalisasi tidak diaktifkan hanya akan terjadi jika metode dipanggil Load secara langsung. Dalam implementasi ASP.NET, metode pembantu internal sebenarnya dipanggil untuk melakukan pemuatan, dan metode pembantu ini secara diam-diam mengembalikan jika personalisasi belum diaktifkan untuk halaman.

Berlaku untuk

Lihat juga