Condividi tramite


PersonalizationAdministration.FindInactiveUserState Metodo

Definizione

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente relativo agli utenti inattivi in base ai parametri specificati.

Overload

FindInactiveUserState(String, String, DateTime)

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente relativo agli utenti inattivi in base ai parametri specificati.

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente relativo agli utenti inattivi in base ai parametri specificati.

FindInactiveUserState(String, String, DateTime)

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente relativo agli utenti inattivi in base ai parametri specificati.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState (string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);
static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection

Parametri

pathToMatch
String

Percorso della pagina da mettere in corrispondenza.

usernameToMatch
String

Nome utente da mettere in corrispondenza alla cui pagina sono associati i dati sulla personalizzazione.

userInactiveSinceDate
DateTime

Data dell'ultimo accesso alle informazioni sulla personalizzazione di un utente.

Restituisce

Un oggetto PersonalizationStateInfoCollection che contiene informazioni di stato sulla personalizzazione per singolo utente.

Eccezioni

pathToMatch o usernameToMatch, dopo l'operazione di taglio, è una stringa vuota ("").

-oppure-

Il tipo di un provider di personalizzazioni definito nella configurazione non è corretto.

-oppure-

La lunghezza della stringa di un parametro è maggiore di 256 caratteri.

Si è verificata un'eccezione di configurazione durante il tentativo di creare e inizializzare un'istanza di uno dei provider di personalizzazioni configurati.

-oppure-

Non è stato possibile trovare il provider di personalizzazioni predefinito nella configurazione.

Commenti

Questo metodo restituisce una raccolta di istanze, informazioni sullo stato di UserPersonalizationStateInfo personalizzazione per utente in cui il valore del pathToMatch parametro corrisponde al percorso di una pagina, usernameToMatch corrisponde a un nome utente con dati di personalizzazione associati a tale pagina e gli utenti vengono considerati inattivi. In altre parole, per ogni record restituito il valore della proprietà dell'utente LastActivityDate è minore o uguale a userInactiveSinceDate. La raccolta restituita contiene solo UserPersonalizationStateInfo istanze.

Questo metodo passa i caratteri jolly di query all'archivio dati sottostante. Il supporto per i caratteri jolly dipende attualmente dal modo in cui ogni provider gestisce i caratteri, ad esempio un asterisco (*), un simbolo percentuale (%), o un carattere di sottolineatura (_).

In genere, per gli archivi dati conformi a SQL, è possibile eseguire una ricerca con caratteri jolly su un percorso parziale con il carattere jolly visualizzato all'inizio, alla fine o al centro del testo della stringa di ricerca nella PathToMatch proprietà. Ad esempio, per trovare tutti i percorsi che iniziano con "~/vdir", la PathToMatch proprietà verrà impostata su "~/vdir%".

Analogamente, una ricerca con caratteri jolly su un nome utente parziale potrebbe avere il carattere jolly visualizzato in qualsiasi punto nella stringa di testo della UsernameToMatch proprietà. Ad esempio, per trovare tutti i nomi utente che iniziano con "John", la UsernameToMatch proprietà sarà simile a "John%".

Usando il provider di personalizzazione predefinito, gli PersonalizationStateInfooggetti derivati vengono restituiti in ordine alfabetico e ordinati in base a una combinazione di percorso e nome utente in ordine crescente. L'ordine degli oggetti nell'insieme è determinato dal provider.

Se userInactiveSinceDate è MaxValue, i valori restituiti da questo metodo sono equivalenti a FindUserState.

Entrambi pathToMatch e usernameToMatch possono essere null. Il usernameToMatch parametro può includere virgole (,) perché alcuni archivi dati, ad esempio quelli che eseguono Microsoft SQL Server, consentono virgole come caratteri jolly.

Vedi anche

Si applica a

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Restituisce un insieme di informazioni di stato sulla personalizzazione per singolo utente relativo agli utenti inattivi in base ai parametri specificati.

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

Parametri

pathToMatch
String

Percorso della pagina da mettere in corrispondenza.

usernameToMatch
String

Nome utente da mettere in corrispondenza alla cui pagina sono associati i dati sulla personalizzazione.

userInactiveSinceDate
DateTime

Data dell'ultimo accesso alle informazioni sulla personalizzazione.

pageIndex
Int32

Indice in base zero della pagina di risultati da restituire.

pageSize
Int32

Numero di record da restituire.

totalRecords
Int32

Numero totale di record disponibili.

Restituisce

Un oggetto PersonalizationStateInfoCollection che contiene informazioni di stato sulla personalizzazione per singolo utente.

Eccezioni

pathToMatch o usernameToMatch, dopo l'operazione di taglio, è una stringa vuota ("").

-oppure-

pageIndex è minore di zero.

-oppure-

pageSize è minore o uguale a zero.

-oppure-

la combinazione di pageIndex e pageSize supera Int32.MaxValue.

-oppure-

Il tipo di un provider di personalizzazioni definito nella configurazione non è corretto.

-oppure-

La lunghezza della stringa di un parametro è maggiore di 256 caratteri.

Si è verificata un'eccezione di configurazione durante il tentativo di creare e inizializzare un'istanza di uno dei provider di personalizzazioni configurati.

-oppure-

Non è stato possibile trovare il provider di personalizzazioni predefinito nella configurazione.

Commenti

Questo metodo restituisce una raccolta di istanze, informazioni sullo stato di UserPersonalizationStateInfo personalizzazione per utente in cui il valore del pathToMatch parametro corrisponde al percorso di una pagina, usernameToMatch corrisponde a un nome utente con dati di personalizzazione associati a tale pagina e gli utenti vengono considerati inattivi. In altre parole, per ogni record restituito il valore della proprietà dell'utente LastActivityDate è minore o uguale a userInactiveSinceDate. La raccolta contiene solo UserPersonalizationStateInfo istanze.

Questo metodo passa i caratteri jolly dei parametri al provider di personalizzazione sottostante, quindi il modo in cui l'archivio dati gestisce questi caratteri dipende dal modo in cui il provider gestisce i caratteri, ad esempio un asterisco (*), un simbolo percentuale (%), o un carattere di sottolineatura (_).

In genere, per gli archivi dati conformi a SQL, è possibile eseguire una ricerca con caratteri jolly su un percorso parziale con il carattere jolly visualizzato all'inizio, alla fine o al centro del testo della stringa di ricerca nella PathToMatch proprietà. Ad esempio, per trovare tutti i percorsi che iniziano con "~/vdir", la PathToMatch proprietà verrà impostata su "~/vdir%".

Analogamente, una ricerca con caratteri jolly su un nome utente parziale potrebbe avere il carattere jolly visualizzato in qualsiasi punto nella stringa di testo della UsernameToMatch proprietà. Ad esempio, per trovare tutti i nomi utente che iniziano con "John", la UsernameToMatch proprietà sarà simile a "John%".

Usando il provider di personalizzazione predefinito, gli PersonalizationStateInfooggetti derivati vengono restituiti in ordine alfabetico e ordinati in base a una combinazione di percorso e nome utente in ordine crescente. L'ordine degli oggetti nell'insieme è determinato dal provider.

Se userInactiveSinceDate è MaxValue, i valori restituiti da questo metodo sono equivalenti a FindUserState.

Entrambi pathToMatch e usernameToMatch possono essere null. Il usernameToMatch parametro può avere virgole (,) perché alcuni archivi dati, ad esempio quelli che eseguono Microsoft SQL Server, consentono virgole come caratteri jolly.

I dati restituiti sono vincolati da pageIndex e pageSize, dove pageIndex controlla i record da restituire e pageSize controlla il numero di record da restituire. Ad esempio, se pageIndex è stato impostato su 0 ed pageSize è stato impostato su 25, i dati restituiti saranno i primi 25 voci. Se pageIndex è stato impostato su 1 ed pageSize è stato impostato su 25, i dati restituiti sarebbero voci da 26 a 50. Il totalRecords parametro restituisce il numero totale di record disponibili.

Vedi anche

Si applica a