Bagikan melalui

PersonalizationProvider.GetCountOfState Metode

  • Referensi

Definisi

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

Saat ditimpa di kelas turunan, mengembalikan jumlah baris di penyimpanan data dasar yang ada dalam cakupan yang ditentukan.

public:
 abstract int GetCountOfState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query);
public abstract int GetCountOfState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query);
abstract member GetCountOfState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery -> int
Public MustOverride Function GetCountOfState (scope As PersonalizationScope, query As PersonalizationStateQuery) As Integer

Parameter

scope
PersonalizationScope

Informasi PersonalizationScope personalisasi yang akan dikueri. Nilai ini tidak boleh null.

query
PersonalizationStateQuery

Yang PersonalizationStateQuery berisi kueri. Nilai ini bisa berupa null.

Mengembalikan

Int32

Jumlah baris di penyimpanan data yang mendasar yang ada untuk parameter yang ditentukan scope .

Keterangan

Metode ini adalah definisi abstrak dari metode administratif untuk mengambil hitungan data personalisasi. Implementasi turunan harus mengikuti logika yang dijelaskan di bawah ini.

Metode ini meneruskan karakter kartubebas kueri ke penyimpanan data yang mendasar. Dukungan untuk karakter kartubebas saat ini bergantung pada bagaimana setiap penyedia menangani karakter seperti tanda bintang (*), simbol persen (%), atau garis bawah (_).

Biasanya, untuk penyimpanan data yang mematuhi SQL, Anda dapat melakukan pencarian kartubebas di jalur parsial dengan karakter kartubebas muncul di awal, akhir, atau tengah teks string pencarian di PathToMatch properti . Misalnya, untuk menemukan semua jalur yang dimulai dengan "~/vdir", PathToMatch properti akan diatur ke "~/vdir%".

Demikian juga, pencarian kartubebas pada nama pengguna parsial dapat memiliki karakter kartubebas muncul pada titik mana pun dalam string UsernameToMatch teks properti. Misalnya, untuk menemukan semua nama pengguna yang dimulai dengan "John", UsernameToMatch parameter akan terlihat seperti "John%".

Batasan kueri berikut berlaku:

  • Jika hanya scope disediakan, dan query adalah null atau semua properti yang query dikembalikan baik null atau nilai default, maka semua rekaman yang cocok dengan parameter yang ditunjukkan scope dihitung.

  • PathToMatch Jika properti bukan null, rekaman yang dihitung juga difilter berdasarkan jalur yang cocok dengan PathToMatch nilai.

  • UsernameToMatch Jika properti bukan null, rekaman yang dihitung juga difilter berdasarkan nama pengguna yang cocok dengan UsernameToMatch nilai properti.

  • UserInactiveSinceDate Jika properti tidak sama dengan MaxValue, rekaman yang dihitung juga difilter untuk mengembalikan hanya rekaman yang terkait dengan pengguna yang tidak aktif. Perbandingan mencakup rekaman di mana LastActivityDate properti kurang dari atau sama dengan UserInactiveSinceDate properti .

Perhatikan bahwa metode ini tidak memvalidasi kombinasi parameter kueri. Misalnya, kode dapat meminta hitungan rekaman status personalisasi yang terkait dengan nama pengguna tertentu dalam cakupan bersama. Karena nama pengguna tidak terkait dengan informasi bersama, jumlah yang dikembalikan akan menjadi nol.

Kombinasi parameter yang berpotensi mengembalikan jumlah bukan nol meliputi:

Berlaku untuk