PersonalizationAdministration.GetCountOfUserState(String) Metodo
Definizione
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.
Restituisce un conteggio degli elementi dello stato di personalizzazione nell'archivio dati sottostante esistente per l'utente specificato.
public:
static int GetCountOfUserState(System::String ^ usernameToMatch);public static int GetCountOfUserState(string usernameToMatch);static member GetCountOfUserState : string -> intPublic Shared Function GetCountOfUserState (usernameToMatch As String) As IntegerParametri
- usernameToMatch
- String
Nome utente associato alle informazioni sullo stato di personalizzazione da recuperare.
Restituisce
Numero di elementi dello stato di personalizzazione per l'utente specificato.
Eccezioni
usernameToMatch è una stringa vuota ("") dopo il taglio.
oppure
Il provider per un provider di personalizzazione definito nella configurazione non è del tipo corretto.
oppure
La lunghezza della stringa di qualsiasi 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 personalizzazione configurati.
oppure
Impossibile trovare il provider di personalizzazione predefinito definito 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 di 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ò includere il carattere jolly in qualsiasi punto della 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.
