Condividi tramite


PersonalizationAdministration.GetCountOfUserState(String) Metodo

Definizione

Restituisce il numero degli elementi relativi allo stato di personalizzazione disponibili nell'archivio dati sottostante per l'utente specificato.

public:
 static int GetCountOfUserState(System::String ^ usernameToMatch);
public static int GetCountOfUserState (string usernameToMatch);
static member GetCountOfUserState : string -> int
Public Shared Function GetCountOfUserState (usernameToMatch As String) As Integer

Parametri

usernameToMatch
String

Nome utente associato alle informazioni di stato sulla personalizzazione da recuperare.

Restituisce

Il numero degli elementi relativi allo stato di personalizzazione per l'utente specificato.

Eccezioni

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

-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.

Il provider predefinito ha restituito un numero negativo per il conteggio.

Commenti

Questo metodo restituisce un conteggio del numero di elementi di personalizzazione per utente nell'archivio dati sottostante esistente per l'oggetto specificato usernameToMatch.

Si noti che il usernameToMatch parametro può includere caratteri jolly. Questo metodo passa caratteri jolly all'archivio dati sottostante. Il supporto dei 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, una ricerca con caratteri jolly su un nome utente parziale può 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", il UsernameToMatch parametro sarà simile a "John%".

Il usernameToMatch parametro può essere null. Se impostato su null, il parametro viene ignorato durante l'esecuzione di query. Il usernameToMatch parametro può avere virgole (,) perché alcuni archivi dati, ad esempio quelli che eseguono Microsoft SQL Server, consentono virgole come caratteri jolly.

Si applica a

Vedi anche