PersonalizationAdministration.GetCountOfUserState(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> intPublic Shared Function GetCountOfUserState (usernameToMatch As String) As IntegerPará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.
