SqlPersonalizationProvider.FindState Metode
Definisi
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.
Mengembalikan koleksi yang berisi nol atau lebih PersonalizationStateInfoobjek turunan, berdasarkan cakupan dan parameter yang ditentukan.
public:
override 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 override 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);
override this.FindState : System.Web.UI.WebControls.WebParts.PersonalizationScope * System.Web.UI.WebControls.WebParts.PersonalizationStateQuery * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Overrides Function FindState (scope As PersonalizationScope, query As PersonalizationStateQuery, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection
Parameter
- scope
- PersonalizationScope
Menunjukkan PersonalizationScope informasi personalisasi yang akan dikueri. Nilai ini tidak boleh null
.
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
Yang PersonalizationStateInfoCollection berisi nol atau lebih PersonalizationStateInfoobjek turunan.
Pengecualian
pageIndex
kurang dari nol.
-atau-
pageSize
kurang dari atau sama dengan nol.
-atau-
Kombinasi pageIndex
dan pageSize
menghasilkan nilai yang lebih besar dari Int32.MaxValue.
-atau-
PathToMatch non-dannull
merupakan string kosong ("") setelah pemangkasan.
-atau-
Panjangnya PathToMatch lebih besar dari 256 karakter saat nilainya non-null
.
-atau-
UsernameToMatch non-null
dan merupakan string kosong setelah pemangkasan.
-atau-
Panjangnya UsernameToMatch lebih besar dari 256 karakter saat nilainya non-null
.
Yang scope
ditentukan bukan nilai yang valid dari PersonalizationScope enumerasi.
Keterangan
Kumpulan item yang dikembalikan dibatasi oleh pageSize
parameter dan pageIndex
, di mana pageSize
mengontrol jumlah rekaman yang akan dikembalikan dan pageIndex
mengontrol 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 yang diurutkan menurut Path dan 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 "~/approot", PathToMatch properti akan diatur ke "~/approot%".
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, danquery
adalahnull
atau semua properti yangquery
dikembalikan baiknull
atau nilai default, maka semua rekaman yang cocok dengan parameter yang ditunjukkanscope
dikembalikan.PathToMatch Jika properti bukan
null
, rekaman yang dikembalikan juga difilter berdasarkan jalur yang cocok dengan PathToMatch nilai properti.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.
User cakupan dalam kombinasi dengan nilai untuk salah satu atau semua PathToMatchproperti , UsernameToMatch, dan UserInactiveSinceDate .
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk