ProfileProvider.FindProfilesByUserName Metode

Referensi

Definisi

Ruang nama:: System.Web.Profile

Rakitan:: System.Web.dll

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.

Saat ditimpa di kelas turunan, mengambil informasi profil untuk profil di mana nama pengguna cocok dengan nama pengguna yang ditentukan.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public abstract System.Web.Profile.ProfileInfoCollection FindProfilesByUserName (System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);

abstract member FindProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * int * int * int -> System.Web.Profile.ProfileInfoCollection

Public MustOverride Function FindProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection

Parameter

authenticationOption: ProfileAuthenticationOption

Salah ProfileAuthenticationOption satu nilai, menentukan apakah anonim, diautentikasi, atau kedua jenis profil dikembalikan.

usernameToMatch: String

Nama pengguna yang akan dicari.

pageIndex: Int32

Indeks halaman hasil yang akan dikembalikan.

pageSize: Int32

Ukuran halaman hasil yang akan dikembalikan.

totalRecords: Int32

Ketika metode ini kembali, berisi jumlah total profil.

Mengembalikan

ProfileInfoCollection

Yang ProfileInfoCollection berisi informasi profil pengguna untuk profil di mana nama pengguna cocok dengan parameter yang disediakan usernameToMatch .

Contoh

Contoh kode berikut menunjukkan tanda tangan metode untuk implementasi FindProfilesByUserName metode . Untuk contoh implementasi lengkap ProfileProvider , lihat Cara: Membangun dan Menjalankan Contoh Penyedia Profil.

public override ProfileInfoCollection FindProfilesByUserName(
    ProfileAuthenticationOption authenticationOption,
    string usernameToMatch,
    int pageIndex,
    int pageSize,
    out int totalRecords)
{
    totalRecords = 0;

    return new ProfileInfoCollection();
}

Public Overrides Function FindProfilesByUserName( _
ByVal authenticationOption As ProfileAuthenticationOption, _
ByVal usernameToMatch As String, _
ByVal pageIndex As Integer, _
ByVal pageSize As Integer, _
 ByRef totalRecords As Integer) As ProfileInfoCollection

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Keterangan

Metode mengembalikan FindProfilesByUserName daftar informasi profil untuk profil di mana nama pengguna cocok dengan parameter yang disediakan usernameToMatch . Hanya data untuk yang applicationName ditentukan dalam file konfigurasi yang dikembalikan. Parameter authenticationOption menentukan apakah hanya profil anonim, hanya profil terautentikasi, atau semua profil yang dicari.

Jika sumber data Anda mendukung kemampuan pencarian tambahan, seperti karakter kartubebas, Anda dapat memberikan kemampuan pencarian yang lebih luas untuk nama pengguna.

Hasil yang dikembalikan oleh FindProfilesByUserName dibatasi oleh pageIndex parameter dan pageSize . Parameter pageSize mengidentifikasi jumlah ProfileInfo maksimum objek yang akan dikembalikan di ProfileInfoCollection. Parameter pageIndex mengidentifikasi halaman hasil mana yang akan dikembalikan, di mana nol mengidentifikasi halaman pertama. Parameter totalRecords adalah out parameter yang diatur ke jumlah total profil pengguna yang tidak aktif untuk yang dikonfigurasi applicationName, berdasarkan authenticationOption parameter dan userInactiveSinceDate . Misalnya, jika ada 13 pengguna untuk yang dikonfigurasi applicationName, dan pageIndex nilainya adalah 1 dengan pageSize 5, yang ProfileInfoCollection dikembalikan akan berisi profil keenam hingga kesepuluh yang dikembalikan. Parameter totalRecords akan diatur ke 13.

Berlaku untuk

Bagikan melalui