Bagikan melalui

PersonalizationAdministration.FindSharedState Metode

Definisi

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

Mengembalikan kumpulan informasi status personalisasi bersama berdasarkan parameter yang ditentukan.

Overload

Nama Deskripsi
FindSharedState(String)

Mengembalikan kumpulan informasi status personalisasi bersama berdasarkan jalur yang ditentukan.
FindSharedState(String, Int32, Int32, Int32)

Mengembalikan kumpulan informasi status personalisasi bersama berdasarkan parameter yang ditentukan.

FindSharedState(String)

Mengembalikan kumpulan informasi status personalisasi bersama berdasarkan jalur yang ditentukan.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState(string pathToMatch);
static member FindSharedState : string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String) As PersonalizationStateInfoCollection

Parameter

pathToMatch
String

Jalur halaman yang cocok.

Mengembalikan

PersonalizationStateInfoCollection

Yang PersonalizationStateInfoCollection berisi informasi status personalisasi bersama.

Pengecualian

ArgumentException

pathToMatch adalah string kosong ("") baik sebelum atau sesudah pemangkasan.

-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 di mana pathToMatch nilai cocok dengan jalur halaman yang telah berbagi data status personalisasi. Koleksi hanya SharedPersonalizationStateInfo 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%".

Menggunakan penyedia personalisasi default, PersonalizationStateInfoobjek -turunan dikembalikan dalam urutan alfabet, dan diurutkan berdasarkan kombinasi jalur dan nama pengguna dalam urutan naik. Pengurutan objek dalam koleksi ditentukan oleh penyedia.

Parameter pathToMatch dapat null. Jika diatur ke null, parameter diabaikan saat melakukan kueri.

Lihat juga

Berlaku untuk

FindSharedState(String, Int32, Int32, Int32)

Mengembalikan kumpulan informasi status personalisasi bersama berdasarkan parameter yang ditentukan.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindSharedState(System::String ^ pathToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindSharedState(string pathToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindSharedState : string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindSharedState (pathToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parameter

pathToMatch
String

Jalur halaman yang cocok.

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 PersonalizationStateInfoCollection berisi informasi status personalisasi bersama.

Pengecualian

ArgumentException

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

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 di mana pathToMatch nilai cocok dengan jalur halaman yang telah berbagi data status personalisasi. Koleksi hanya SharedPersonalizationStateInfo 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%".

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.

Parameter pathToMatch dapat null. Jika diatur ke null, parameter diabaikan saat melakukan kueri.

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