PersonalizationProvider Kelas

Referensi

Definisi

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

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menerapkan fungsionalitas dasar untuk penyedia personalisasi.

public ref class PersonalizationProvider abstract : System::Configuration::Provider::ProviderBase

public abstract class PersonalizationProvider : System.Configuration.Provider.ProviderBase

type PersonalizationProvider = class
    inherit ProviderBase

Public MustInherit Class PersonalizationProvider
Inherits ProviderBase

Warisan: Object

ProviderBase
PersonalizationProvider

Turunan: System.Web.UI.WebControls.WebParts.SqlPersonalizationProvider

Keterangan

Ini adalah kelas dasar abstrak yang mendefinisikan fungsionalitas yang diperlukan dari penyedia personalisasi. Penyedia personalisasi memuat dan menyimpan data personalisasi atas WebPartPersonalization nama instans.

Kelas dasar mendefinisikan perilaku standar untuk sejumlah metode; hanya metode yang secara khusus berurusan dengan penyimpanan data yang mendasar yang ditandai abstrak. Hal ini memungkinkan pengembang untuk menulis penyedia kustom untuk berinteraksi dengan penyimpanan data tertentu, tanpa perlu menerapkan kembali fungsionalitas standar yang WebPartPersonalization digunakan oleh kelas .

Catatan Bagi Implementer

Anda dapat memperoleh dari PersonalizationProvider dan menyediakan implementasi hanya untuk metode abstrak yang ditentukan dalam kelas ini. Metode abstrak menangani secara khusus dengan menyimpan dan memuat data ke penyimpanan data fisik, dan dengan administrasi penyimpanan data. Penyedia kustom harus mampu memanipulasi informasi personalisasi dengan cara yang membedakan Shared data dari User data. Selain itu, penyedia harus mengesegmentasi data personalisasi berdasarkan halaman serta berdasarkan aplikasi.

PersonalizationProvider Implementasi digabungkan erat dengan implementasi PersonalizationState karena beberapa metode penyedia personalisasi mengembalikan instans PersonalizationStatekelas -turunan. Untuk memudahkan pengembangan penyedia kustom, PersonalizationProvider kelas dasar mencakup implementasi default logika personalisasi dan logika serialisasi/deserialisasi yang digunakan langsung oleh WebPartPersonalization kelas . Akibatnya, penulisan penyedia kustom hanya untuk tujuan bekerja dengan penyimpanan data yang berbeda hanya memerlukan implementasi metode abstrak berikut:

GetCountOfState(PersonalizationScope, PersonalizationStateQuery) - Metode ini harus dapat menghitung jumlah baris data personalisasi dalam database untuk parameter kueri yang disediakan.
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]) - Mengingat jalur dan nama pengguna, metode ini memuat dua objek besar biner (BLOB) dari database: satu BLOB untuk data bersama dan satu untuk data pengguna. Jika Anda memberikan nama dan jalur pengguna, maka Anda tidak memerlukan WebPartManager kontrol untuk mengakses informasi halaman yang dapat memberikan informasi nama pengguna/jalur.
ResetPersonalizationBlob(WebPartManager, String, String) - Mengingat jalur dan nama pengguna, metode ini menghapus baris yang sesuai dalam database. Jika Anda memberikan nama dan jalur pengguna, maka Anda tidak memerlukan WebPartManager kontrol untuk mengakses informasi halaman yang dapat memberikan informasi nama pengguna/jalur.
SavePersonalizationBlob(WebPartManager, String, String, Byte[]) - Mengingat jalur dan nama pengguna, metode ini menyimpan BLOB yang disediakan ke database. Jika Anda memberikan nama dan jalur pengguna, maka Anda tidak memerlukan WebPartManager kontrol untuk mengakses informasi halaman yang dapat memberikan informasi nama pengguna/jalur.

Dalam semua metode ini, jika hanya jalur yang disediakan, yang menunjukkan data personalisasi bersama untuk halaman sedang dioperasikan. Jika jalur dan nama pengguna diteruskan ke metode , maka data personalisasi pengguna untuk halaman harus ditindaklanjuti. Dalam kasus LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[]), data bersama untuk jalur yang ditentukan harus selalu dimuat, dan secara opsional data personalisasi pengguna untuk jalur juga harus dimuat jika nama pengguna bukan null.

Semua metode abstrak lainnya hanya ditujukan untuk digunakan dalam aplikasi administratif dan tidak digunakan oleh infrastruktur Bagian Web pada durasi. Untuk contoh implementasi penyedia personalisasi, lihat SqlPersonalizationProvider kelas .

Konstruktor

PersonalizationProvider()

Menginisialisasi instans baru kelas PersonalizationProvider.

Properti

ApplicationName	Ketika ditimpa di kelas turunan, mendapatkan atau mengatur nama aplikasi yang dikonfigurasi untuk penyedia.
Description	Mendapatkan deskripsi singkat dan ramah yang cocok untuk ditampilkan di alat administratif atau antarmuka pengguna (UI) lainnya. (Diperoleh dari ProviderBase)
Name	Mendapatkan nama ramah yang digunakan untuk merujuk ke penyedia selama konfigurasi. (Diperoleh dari ProviderBase)

Metode

CreateSupportedUserCapabilities()	Mengembalikan daftar WebPartUserCapability objek yang mewakili kumpulan kapabilitas yang diketahui yang digunakan oleh kumpulan kontrol Bagian Web.
DetermineInitialScope(WebPartManager, PersonalizationState)	Menentukan apakah cakupan personalisasi awal harus Shared atau User cakupan.
DetermineUserCapabilities(WebPartManager)	Mengembalikan kamus yang berisi WebPartUserCapability instans yang mewakili kemampuan terkait personalisasi dari akun pengguna yang sedang dijalankan.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FindState(PersonalizationScope, PersonalizationStateQuery, Int32, Int32, Int32)	Saat ditimpa di kelas turunan, mengembalikan koleksi yang berisi nol atau lebih PersonalizationStateInfoobjek turunan berdasarkan cakupan dan parameter kueri tertentu.
GetCountOfState(PersonalizationScope, PersonalizationStateQuery)	Saat ditimpa di kelas turunan, mengembalikan jumlah baris di penyimpanan data dasar yang ada dalam cakupan yang ditentukan.
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
Initialize(String, NameValueCollection)	Menginisialisasi penyusun konfigurasi. (Diperoleh dari ProviderBase)
LoadPersonalizationBlobs(WebPartManager, String, String, Byte[], Byte[])	Saat ditimpa di kelas turunan, memuat data personalisasi mentah dari penyimpanan data yang mendasar.
LoadPersonalizationState(WebPartManager, Boolean)	Memuat data mentah dari penyimpanan data yang mendasar dan mengonversi data tersebut menjadi PersonalizationState objek.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ResetPersonalizationBlob(WebPartManager, String, String)	Saat ditimpa di kelas turunan, menghapus data personalisasi mentah dari penyimpanan data yang mendasar.
ResetPersonalizationState(WebPartManager)	Mereset data personalisasi ke penyimpanan data yang mendasar.
ResetState(PersonalizationScope, String[], String[])	Saat ditimpa di kelas turunan, menghapus status personalisasi dari penyimpanan data yang mendasar berdasarkan parameter yang ditentukan.
ResetUserState(String, DateTime)	Saat ditimpa di kelas turunan, menghapus data personalisasi Bagian Web dari penyimpanan data yang mendasar berdasarkan parameter yang ditentukan.
SavePersonalizationBlob(WebPartManager, String, String, Byte[])	Saat ditimpa di kelas turunan, menyimpan data personalisasi mentah ke penyimpanan data yang mendasar.
SavePersonalizationState(PersonalizationState)	Menyimpan data personalisasi ke penyimpanan data.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Berlaku untuk

Bagikan melalui