PersonalizationAdministration.GetCountOfUserState(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna uma contagem dos itens de estado de personalização no armazenamento de dados subjacente que existe para o usuário 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
O nome de usuário associado às informações de estado de personalização a serem recuperadas.
Retornos
O número de itens de estado de personalização para o usuário especificado.
Exceções
usernameToMatch é uma cadeia de caracteres vazia ("") após a filtragem.
- ou -
O provedor para um provedor de personalização definido na configuração não é do tipo correto.
- ou -
O comprimento da cadeia de caracteres de qualquer parâmetro é maior do que 256 caracteres.
Ocorreu uma exceção de configuração durante a tentativa de criar e inicializar uma instância de um dos provedores de personalização configurados.
- ou -
Não foi possível encontrar o provedor de personalização padrão definido na configuração.
O provedor padrão retornou um número negativo para a contagem.
Comentários
Esse método retorna uma contagem do número de itens de personalização por usuário no armazenamento de dados subjacente que existe para o determinado usernameToMatch.
Observe que o usernameToMatch parâmetro pode incluir caracteres curinga. Esse método passa caracteres curinga para o armazenamento de dados subjacente. Atualmente, o suporte a caracteres curinga depende de como cada provedor lida com caracteres como um asterisco (*), um símbolo de porcentagem (%) ou um sublinhado (_).
Normalmente, para armazenamentos de dados em conformidade com SQL, uma pesquisa curinga em um nome de usuário parcial pode fazer com que o caractere curinga apareça em qualquer ponto na cadeia de caracteres de texto da UsernameToMatch propriedade. Por exemplo, para localizar todos os nomes de usuário que começam com "John", o UsernameToMatch parâmetro se pareceria com "John%".
O usernameToMatch parâmetro pode ser null. Se definido nullcomo , o parâmetro será ignorado ao executar consultas. O usernameToMatch parâmetro tem permissão para ter vírgulas (,) porque alguns armazenamentos de dados, como aqueles que executam o Microsoft SQL Server, permitem vírgulas como caracteres curinga.
