PersonalizationProvider.FindState Metode

Definisi

Ruang nama:

System.Web.UI.WebControls.WebParts

Rakitan:

System.Web.dll

Saat ditimpa di kelas turunan, mengembalikan koleksi yang berisi nol atau lebih PersonalizationStateInfoobjek turunan berdasarkan cakupan dan parameter kueri tertentu.

public:
 abstract System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindState(System::Web::UI::WebControls::WebParts::PersonalizationScope scope, System::Web::UI::WebControls::WebParts::PersonalizationStateQuery ^ query, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindState (System.Web.UI.WebControls.WebParts.PersonalizationScope scope, System.Web.UI.WebControls.WebParts.PersonalizationStateQuery query, int pageIndex, int pageSize, out int totalRecords);

abstract member FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public MustOverride Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parameter

scope

PersonalizationScope

A PersonalizationScope dengan informasi personalisasi yang akan dikueri. Nilai ini tidak boleh null.

query

PersonalizationStateQuery

Yang PersonalizationStateQuery berisi kueri. Nilai ini bisa berupa null.

pageIndex

Int32

Lokasi di mana kueri dimulai.

pageSize

Int32

Jumlah rekaman yang akan dikembalikan.

totalRecords

Int32

Jumlah total rekaman yang tersedia.

Mengembalikan

PersonalizationStateInfoCollection

Yang PersonalizationStateInfoCollection berisi nol atau lebih PersonalizationStateInfoobjek turunan.

Keterangan

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

Kumpulan item yang dikembalikan dibatasi oleh pageIndex parameter dan pageSize , di mana pageSize mengatur jumlah rekaman yang akan dikembalikan dan pageIndex mengatur rekaman mana yang akan dikembalikan. Misalnya, pageIndex dari 0 dan pageSize dari 25 akan mengembalikan 25 kemunculan pertama, sedangkan pageIndex 1 dan pageSize dari 25 akan mengembalikan kemunculan 26-50. Jika Anda ingin mengambil semua rekaman yang tersedia, atur pageIndex ke 0 dan pageSize ke MaxValue.

Objek PersonalizationStateInfo-turunan dikembalikan dalam urutan alfabet dan diurutkan berdasarkan kombinasi Path nilai properti dannya Username , keduanya dalam urutan naik.

Metode ini meneruskan karakter kartubebas kueri ke penyimpanan data yang mendasar. Dukungan untuk karakter kartubebas saat ini tergantung 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 di 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 dikembalikan.

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

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

• UserInactiveSinceDate Jika properti tidak sama dengan MaxValue, rekaman yang dikembalikan 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 sekumpulan rekaman status personalisasi yang terkait dengan nama pengguna tertentu dalam cakupan bersama. Karena nama pengguna tidak terkait dengan informasi bersama, koleksi yang dikembalikan akan kosong.

Kombinasi parameter yang berpotensi mengembalikan koleksi yang tidak kosong meliputi:

• Shared cakupan dalam kombinasi dengan PathToMatch properti .

• User cakupan dalam kombinasi dengan nilai untuk salah satu atau semua PathToMatchproperti , UsernameToMatch, dan UserInactiveSinceDate .