ProfileProvider.FindInactiveProfilesByUserName Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.Profile

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Se sottoposto a override in una classe derivata, recupera le informazioni sui profili in cui la data dell'ultima attività corrisponde o è precedente alla data specificata e in cui il nome utente corrisponde a quello 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 valori dell'enumerazione ProfileAuthenticationOption che specifica se vengono restituiti profili di tipo anonimo, autenticato o entrambi.

usernameToMatch: String

Nome utente da cercare.

userInactiveSinceDate: DateTime

Oggetto DateTime che identifica i profili utente considerati inattivi. Se il valore specificato nella proprietà LastActivityDate di un profilo utente corrisponde o è precedente alla data e all'ora specificate in questo parametro, il profilo viene considerato inattivo.

pageIndex: Int32

Indice della pagina di risultati da restituire.

pageSize: Int32

Dimensione della pagina di risultati da restituire.

totalRecords: Int32

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

Restituisce

ProfileInfoCollection

Un oggetto ProfileInfoCollection che contiene le informazioni sui profili utente inattivi in cui il nome utente corrisponde al parametro usernameToMatch fornito.

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, ad esempio caratteri jolly, è possibile offrire funzionalità di ricerca più estese 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 in 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 applicationName, in 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 fino al decimo profilo inattivo restituito. Il totalRecords parametro verrà impostato su 13.

Si applica a