Aracılığıyla paylaş

ProfileProvider.FindProfilesByUserName Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Web.Profile
Bütünleştirilmiş Kod:
System.Web.dll

Türetilmiş bir sınıfta geçersiz kılındığında, kullanıcı adının belirtilen kullanıcı adlarıyla eşleştiği profiller için profil bilgilerini alır.

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

Parametreler

authenticationOption
ProfileAuthenticationOption

ProfileAuthenticationOption Anonim, kimliği doğrulanmış veya her iki profil türünün de döndürüleceğini belirten değerlerden biri.

usernameToMatch
String

Aranacak kullanıcı adı.

pageIndex
Int32

Döndürülecek sonuç sayfasının dizini.

pageSize
Int32

Döndürülecek sonuç sayfasının boyutu.

totalRecords
Int32

Bu yöntem döndürdüğünde, toplam profil sayısını içerir.

Döndürülenler

ProfileInfoCollection

ProfileInfoCollection Kullanıcı adının sağlanan usernameToMatch parametreyle eşleştiği profiller için kullanıcı profili bilgilerini içeren.

Örnekler

Aşağıdaki kod örneği, yönteminin uygulanması için yöntem imzasını FindProfilesByUserName gösterir. Tam ProfileProvider uygulama örneği için bkz . Nasıl yapılır: Profil Sağlayıcısı Örneği Oluşturma ve Çalıştırma.

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

Açıklamalar

yöntemi, FindProfilesByUserName kullanıcı adının sağlanan usernameToMatch parametreyle eşleşdiği profiller için profil bilgilerinin listesini döndürür. Yalnızca yapılandırma dosyasında belirtilen veriler applicationName döndürülür. authenticationOption parametresi yalnızca anonim profillerin mi, yalnızca kimliği doğrulanmış profillerin mi yoksa tüm profillerin mi arandığını belirtir.

Veri kaynağınız joker karakterler gibi ek arama özelliklerini destekliyorsa, kullanıcı adları için daha kapsamlı arama özellikleri sağlayabilirsiniz.

tarafından FindProfilesByUserName döndürülen sonuçlar ve pageSize parametreleriyle pageIndex kısıtlanır. parametresi, pageSize içinde ProfileInfoCollectiondöndürülecek en fazla nesne sayısını ProfileInfo tanımlar. pageIndex parametresi, döndürülecek sonuç sayfasını ve sıfırın ilk sayfayı tanımladığı sayfayı tanımlar. totalRecords parametresi, ve userInactiveSinceDate parametrelerine göre authenticationOption yapılandırılan applicationNameiçin etkin olmayan kullanıcı profillerinin toplam sayısına ayarlanmış bir out parametredir. Örneğin, yapılandırılmış applicationNameiçin 13 kullanıcı varsa ve pageIndex değer 5 ile 1 pageSize ise, ProfileInfoCollection döndürülen altıncı ile onuncu etkin olmayan profiller döndürülür. totalRecords parametresi 13 olarak ayarlanır.

Şunlara uygulanır

Ayrıca bkz.