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 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 -> intPublic Shared Function GetCountOfUserState (usernameToMatch As String) As IntegerParametri
- 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 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.