ProfileProvider.FindInactiveProfilesByUserName Metodo

Definizione

Spazio dei nomi:
System.Web.Profile
Assembly:
System.Web.dll

In caso di override in una classe derivata, recupera le informazioni sul profilo per i profili in cui si è verificata l'ultima data dell'attività in corrispondenza o prima della data specificata e il nome utente corrisponde al nome utente specificato.

public:
 abstract System::Web::Profile::ProfileInfoCollection ^ FindInactiveProfilesByUserName(System::Web::Profile::ProfileAuthenticationOption authenticationOption, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public abstract System.Web.Profile.ProfileInfoCollection FindInactiveProfilesByUserName(System.Web.Profile.ProfileAuthenticationOption authenticationOption, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);
abstract member FindInactiveProfilesByUserName : System.Web.Profile.ProfileAuthenticationOption * string * DateTime * int * int * int -> System.Web.Profile.ProfileInfoCollection
Public MustOverride Function FindInactiveProfilesByUserName (authenticationOption As ProfileAuthenticationOption, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection

Parametri

authenticationOption
ProfileAuthenticationOption

Uno dei ProfileAuthenticationOption valori, specificando se vengono restituiti profili anonimi, autenticati o entrambi i tipi.

usernameToMatch
String

Nome utente da cercare.

userInactiveSinceDate
DateTime

Oggetto DateTime che identifica i profili utente considerati inattivi. Se il LastActivityDate valore di un profilo utente si verifica su o prima di questa data e ora, il profilo viene considerato inattivo.

pageIndex
Int32

Indice della pagina dei risultati da restituire.

pageSize
Int32

Dimensioni della pagina dei risultati da restituire.

totalRecords
Int32

Quando termina, questo metodo contiene il numero totale di profili.

Valori restituiti

ProfileInfoCollection

Oggetto ProfileInfoCollection contenente le informazioni sul profilo utente per i profili inattivi in cui il nome utente corrisponde al parametro specificato usernameToMatch .

Esempio

Nell'esempio di codice seguente viene illustrata la firma del metodo per un'implementazione del FindInactiveProfilesByUserName metodo . Per un esempio di implementazione completa ProfileProvider , vedere Procedura: Compilare ed eseguire l'esempio del provider di profili.

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

    return new ProfileInfoCollection();
}

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

  totalRecords = 0

  Return New ProfileInfoCollection()
End Function

Commenti

Il FindInactiveProfilesByUserName metodo viene usato per recuperare le informazioni sul profilo per i profili utente inutilizzati per i profili in cui il nome utente corrisponde al parametro specificato usernameToMatch . Vengono restituiti solo i dati per l'oggetto applicationName specificato nel file di configurazione. Il authenticationOption parametro specifica se vengono cercati solo profili anonimi, solo profili autenticati o tutti i profili. Dei profili di ricerca, qualsiasi profilo con un LastActivityDate oggetto che si verifica su o prima che venga restituito il valore del parametro specificato userInactiveSinceDate .

Se l'origine dati supporta funzionalità di ricerca aggiuntive, come i caratteri jolly, potete ampliare le capacità di ricerca per i nomi utente.

I risultati restituiti da FindInactiveProfilesByUserName sono vincolati dai pageIndex parametri e pageSize . Il pageSize parametro identifica il numero massimo di ProfileInfo oggetti da restituire nell'oggetto ProfileInfoCollection. Il pageIndex parametro identifica la pagina dei risultati da restituire, dove zero identifica la prima pagina. Il totalRecords parametro è un out parametro impostato sul numero totale di profili utente inattivi per l'oggetto configurato applicationNamein base ai authenticationOption parametri e userInactiveSinceDate . Ad esempio, se sono presenti 13 utenti per l'oggetto configurato applicationNamee il pageIndex valore è 1 con un pageSize valore pari a 5, il ProfileInfoCollection valore restituito conterrà il sesto tramite il decimo profilo inattivo restituito. Il totalRecords parametro verrà impostato su 13.

Si applica a

Vedi anche