PersonalizationAdministration.FindInactiveUserState 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 untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
Overload
FindInactiveUserState(String, String, DateTime) |
Mengembalikan kumpulan informasi status personalisasi per pengguna untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan. |
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32) |
Mengembalikan kumpulan informasi status personalisasi per pengguna untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan. |
FindInactiveUserState(String, String, DateTime)
Mengembalikan kumpulan informasi status personalisasi per pengguna untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);
static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection
Parameter
- pathToMatch
- String
Jalur halaman yang akan dicocokkan.
- usernameToMatch
- String
Nama pengguna yang cocok dengan data personalisasi yang terkait dengan halaman.
- userInactiveSinceDate
- DateTime
Tanggal terakhir informasi personalisasi pengguna diakses.
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.
Keterangan
Metode ini mengembalikan kumpulan UserPersonalizationStateInfo instans, informasi status personalisasi per pengguna di mana pathToMatch
nilai parameter cocok dengan jalur halaman, usernameToMatch
cocok dengan nama pengguna yang memiliki data personalisasi yang terkait dengan halaman tersebut, dan pengguna dianggap tidak aktif. Dengan kata lain, untuk setiap rekaman yang dikembalikan, nilai properti pengguna LastActivityDate kurang dari atau sama dengan userInactiveSinceDate
. Koleksi yang dikembalikan hanya UserPersonalizationStateInfo berisi instans.
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 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.
Jika userInactiveSinceDate
adalah MaxValue, maka nilai yang dikembalikan dari metode ini setara dengan FindUserState.
Baik pathToMatch
dan usernameToMatch
dapat berupa null
. Parameter usernameToMatch
dapat menyertakan koma (,) karena beberapa penyimpanan data, seperti yang menjalankan Microsoft SQL Server, memungkinkan koma sebagai karakter kartubebas.
Lihat juga
- WebPartPersonalization
- ASP.NET Kontrol Bagian Web
- Gambaran Umum Personalisasi Bagian Web
- Panduan: Menerapkan Personalisasi Bagian Web dengan Kontrol Pengguna
- Personalisasi Bagian Web
Berlaku untuk
FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)
Mengembalikan kumpulan informasi status personalisasi per pengguna untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.
public:
static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);
static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection
Parameter
- pathToMatch
- String
Jalur halaman yang akan dicocokkan.
- usernameToMatch
- String
Nama pengguna yang cocok dengan data personalisasi yang terkait dengan halaman.
- userInactiveSinceDate
- DateTime
Informasi personalisasi tanggal terakhir diakses.
- pageIndex
- Int32
Indeks berbasis nol dari halaman hasil yang akan dikembalikan.
- pageSize
- Int32
Jumlah rekaman yang akan dikembalikan.
- totalRecords
- Int32
Jumlah total 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.
Keterangan
Metode ini mengembalikan kumpulan UserPersonalizationStateInfo instans, informasi status personalisasi per pengguna di mana pathToMatch
nilai parameter cocok dengan jalur halaman, usernameToMatch
cocok dengan nama pengguna yang memiliki data personalisasi yang terkait dengan halaman tersebut, dan pengguna dianggap tidak aktif. Dengan kata lain, untuk setiap rekaman yang dikembalikan, nilai properti pengguna LastActivityDate kurang dari atau sama dengan userInactiveSinceDate
. Koleksi hanya UserPersonalizationStateInfo berisi instans.
Metode ini meneruskan karakter kartubebas parameter ke penyedia personalisasi yang mendasar, jadi bagaimana penyimpanan data menangani karakter ini tergantung 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 di 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.
Jika userInactiveSinceDate
adalah MaxValue, maka nilai yang dikembalikan dari metode ini setara dengan FindUserState.
Baik pathToMatch
dan usernameToMatch
dapat berupa 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
mengontrol 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 Bagian Web
- Gambaran Umum Personalisasi Bagian Web
- Panduan: Menerapkan Personalisasi Bagian Web dengan Kontrol Pengguna
- Personalisasi Bagian Web
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