PersonalizationAdministration.FindUserState 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 kumpulan informasi status personalisasi per pengguna berdasarkan parameter yang ditentukan.
Overload
| FindUserState(String, String) |
Mengembalikan kumpulan informasi status personalisasi per pengguna berdasarkan nama pengguna dan jalur halaman. |
| FindUserState(String, String, Int32, Int32, Int32) |
Mengembalikan kumpulan informasi status personalisasi per pengguna berdasarkan parameter yang ditentukan. |
FindUserState(String, String)
Mengembalikan kumpulan informasi status personalisasi per pengguna berdasarkan nama pengguna dan jalur halaman.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch);static member FindUserState : string * string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollectionParameter
- pathToMatch
- String
Jalur halaman yang cocok.
- usernameToMatch
- String
Nama pengguna yang cocok dengan data personalisasi yang terkait dengan halaman.
Mengembalikan
PersonalizationStateInfoCollection yang berisi informasi status personalisasi per pengguna.
Pengecualian
pathToMatch atau usernameToMatch sebelum atau sesudah pemangkasan adalah string kosong ("").
-atau-
Penyedia untuk penyedia personalisasi yang ditentukan dalam konfigurasi bukan tipe yang benar.
-atau-
Panjang string parameter apa pun lebih besar dari 256 karakter.
Pengecualian konfigurasi terjadi saat mencoba membuat dan menginisialisasi instans salah satu penyedia personalisasi yang dikonfigurasi.
-atau-
Penyedia personalisasi default yang ditentukan dalam konfigurasi tidak dapat ditemukan.
Contoh
Contoh kode berikut menunjukkan cara menggunakan FindUserState metode . Contoh lengkap dapat ditemukan di PersonalizationAdministration topik gambaran umum kelas.
Penting
Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
Keterangan
Metode ini mengembalikan kumpulan UserPersonalizationStateInfo instans di mana pathToMatch nilai parameter cocok dengan jalur halaman, dan usernameToMatch cocok dengan nama pengguna yang memiliki data personalisasi yang terkait dengan halaman tersebut. Koleksi hanya UserPersonalizationStateInfo berisi instans.
Metode ini meneruskan karakter kartubebas parameter ke penyedia personalisasi yang mendasar, jadi bagaimana penyimpanan data menangani karakter ini bergantung pada bagaimana 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 properti akan terlihat seperti "John%".
Menggunakan penyedia personalisasi default, PersonalizationStateInfoobjek -turunan dikembalikan dalam urutan alfabet, dan diurutkan berdasarkan kombinasi jalur dan nama pengguna dalam urutan naik. Urutan objek dalam koleksi ditentukan oleh penyedia.
Baik pathToMatch dan usernameToMatch bisa .null Parameter usernameToMatch dapat memiliki koma (,) karena beberapa penyimpanan data, seperti yang menjalankan Microsoft SQL Server, memungkinkan koma sebagai karakter kartubebas.
Lihat juga
- WebPartPersonalization
- ASP.NET Kontrol Komponen Web
- Gambaran Umum Personalisasi Bagian Web
- Panduan: Menerapkan Personalisasi Bagian Web dengan Kontrol Pengguna
- Personalisasi Bagian Web
Berlaku untuk
FindUserState(String, String, Int32, Int32, Int32)
Mengembalikan kumpulan informasi status personalisasi per pengguna berdasarkan parameter yang ditentukan.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollectionPublic Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollectionParameter
- pathToMatch
- String
Jalur halaman yang cocok.
- usernameToMatch
- String
Nama pengguna yang cocok dengan data personalisasi yang terkait dengan halaman.
- pageIndex
- Int32
Indeks berbasis nol dari halaman hasil yang akan dikembalikan.
- pageSize
- Int32
Jumlah rekaman yang akan dikembalikan.
- totalRecords
- Int32
Jumlah total atau rekaman yang tersedia.
Mengembalikan
PersonalizationStateInfoCollection yang berisi informasi status personalisasi per pengguna.
Pengecualian
pathToMatch atau usernameToMatch sebelum atau sesudah pemangkasan adalah string kosong ("").
-atau-
pageIndex kurang dari nol.
-atau-
pageSize kurang dari atau sama dengan nol.
-atau-
Kombinasi pageIndex dan pageSize melebihi Int32.MaxValue.
-atau-
Penyedia untuk penyedia personalisasi yang ditentukan dalam konfigurasi bukan tipe yang benar.
-atau-
Panjang string parameter apa pun lebih besar dari 256 karakter.
Pengecualian konfigurasi terjadi saat mencoba membuat dan menginisialisasi instans salah satu penyedia personalisasi yang dikonfigurasi.
-atau-
Penyedia personalisasi default yang ditentukan dalam konfigurasi tidak dapat ditemukan.
Contoh
Contoh kode berikut menunjukkan cara menggunakan FindUserState metode . Contoh lengkap dapat ditemukan di PersonalizationAdministration topik gambaran umum kelas.
Penting
Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.
protected void Button1_Click(object sender, EventArgs e)
{
if (TextBox3.Text != null)
{
PersonalizationStateInfoCollection findresult;
findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
if (findresult.Count != 0)
{
Label4.Text = findresult.Count + " user(s) found";
Label4.Visible = true;
}
else
{
Label4.Text = "No users found.";
Label4.Visible = true;
}
}
else
{
Label4.Text = "You must enter a user name to find.";
}
}
Keterangan
Metode ini mengembalikan kumpulan UserPersonalizationStateInfo instans di mana pathToMatch nilai parameter cocok dengan jalur halaman dan usernameToMatch cocok dengan nama pengguna yang memiliki data personalisasi yang terkait dengan halaman tersebut. Koleksi hanya UserPersonalizationStateInfo berisi instans.
Metode ini meneruskan karakter kartubebas parameter ke penyedia personalisasi yang mendasar, jadi bagaimana penyimpanan data menangani karakter ini bergantung pada bagaimana penyedia menangani karakter sebagai 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 properti akan terlihat seperti "John%".
Menggunakan penyedia personalisasi default, PersonalizationStateInfoobjek -turunan dikembalikan dalam urutan alfabet, dan diurutkan berdasarkan kombinasi jalur dan nama pengguna dalam urutan naik. Urutan objek dalam koleksi ditentukan oleh penyedia.
Baik pathToMatch dan usernameToMatch bisa .null Parameter usernameToMatch dapat memiliki koma (,) karena beberapa penyimpanan data, seperti yang menjalankan Microsoft SQL Server, memungkinkan koma sebagai karakter kartubebas.
Data yang dikembalikan dibatasi oleh pageIndex dan pageSize, di mana pageIndex kontrol rekaman mana yang akan dikembalikan dan pageSize mengontrol jumlah rekaman yang akan dikembalikan. Misalnya, jika pageIndex diatur ke 0 dan pageSize diatur ke 25, data yang dikembalikan akan menjadi 25 entri pertama. Jika pageIndex diatur ke 1 dan pageSize diatur ke 25, data yang dikembalikan akan menjadi entri 26 hingga 50. Parameter totalRecords mengembalikan jumlah total rekaman yang tersedia.
Lihat juga
- WebPartPersonalization
- ASP.NET Kontrol Komponen Web
- Gambaran Umum Personalisasi Bagian Web
- Panduan: Menerapkan Personalisasi Bagian Web dengan Kontrol Pengguna
- Personalisasi Bagian Web
Berlaku untuk
Saran dan Komentar
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: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk