PersonalizationAdministration.FindInactiveUserState Metode

Definisi

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

Mengembalikan kumpulan informasi status personalisasi per pengguna untuk pengguna yang tidak aktif, berdasarkan parameter yang ditentukan.

Overload

Nama Deskripsi
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 cocok.

usernameToMatch
String

Nama pengguna yang cocok dengan data personalisasi yang terkait dengan halaman.

userInactiveSinceDate
DateTime

Tanggal terakhir informasi personalisasi pengguna diakses.

Mengembalikan

PersonalizationStateInfoCollection

PersonalizationStateInfoCollection yang berisi informasi status personalisasi per pengguna.

Pengecualian

ArgumentException

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.

ConfigurationErrorsException

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 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 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 bisa .null Parameter usernameToMatch dapat mencakup koma (,) karena beberapa penyimpanan data, seperti yang menjalankan Microsoft SQL Server, memungkinkan koma sebagai karakter kartubebas.

Lihat juga

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 cocok.

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

PersonalizationStateInfoCollection yang berisi informasi status personalisasi per pengguna.

Pengecualian

ArgumentException

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 dan pageIndexpageSize 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.

ConfigurationErrorsException

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 wildcard 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 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.

Jika userInactiveSinceDate adalah MaxValue, maka nilai yang dikembalikan dari metode ini setara dengan FindUserState.

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 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

Berlaku untuk