Compartir a través de


PersonalizationAdministration.GetCountOfUserState(String) Método

Definición

Devuelve el número de elementos de estado de personalización del almacén de datos subyacente que existe para el usuario especificado.

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

Parámetros

usernameToMatch
String

Nombre de usuario asociado a la información de estado de personalización que se va a recuperar.

Devoluciones

Número de elementos de estado de personalización del usuario especificado.

Excepciones

usernameToMatch es una cadena vacía ("") después de recortar.

o bien

El proveedor de un proveedor de personalización definido en la configuración no es del tipo correcto.

o bien

La longitud de la cadena de cualquier parámetro tiene más de 256 caracteres.

Se ha producido una excepción de configuración cuando se intentaba crear e inicializar una instancia de uno de los proveedores de personalización configurados.

o bien

No se encuentra el proveedor de personalización predeterminado definido en la configuración.

El proveedor predeterminado devolvió un número negativo para el recuento.

Comentarios

Este método devuelve un recuento del número de elementos de personalización por usuario en el almacén de datos subyacente que existe para el especificado usernameToMatch.

Tenga en cuenta que el usernameToMatch parámetro puede incluir caracteres comodín. Este método pasa caracteres comodín al almacén de datos subyacente. La compatibilidad con caracteres comodín depende actualmente de cómo cada proveedor controla caracteres como un asterisco (*), un símbolo de porcentaje (%) o un carácter de subrayado (_).

Normalmente, para los almacenes de datos compatibles con SQL, una búsqueda con caracteres comodín en un nombre de usuario parcial puede tener el carácter comodín en cualquier punto de la cadena de texto de la UsernameToMatch propiedad. Por ejemplo, para buscar todos los nombres de usuario que comienzan por "John", el UsernameToMatch parámetro tendría el aspecto de "John%".

El usernameToMatch parámetro puede ser null. Si se establece en null, se omite el parámetro al realizar consultas. El usernameToMatch parámetro puede tener comas (,) porque algunos almacenes de datos, como los que ejecutan Microsoft SQL Server, permiten comas como caracteres comodín.

Se aplica a

Consulte también