PersonalizationAdministration.GetCountOfUserState(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Devolve uma contagem dos itens de estado de personalização no armazenamento de dados subjacente que existem para o utilizador 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 utilizador associado à informação de estado de personalização a recuperar.
Devoluções
O número de itens de estado de personalização para o utilizador especificado.
Exceções
usernameToMatch é um fio vazio ("") após aparar.
-ou-
O fornecedor para um fornecedor de personalização definido em configuração não é do tipo correto.
-ou-
O comprimento da cadeia de qualquer parâmetro é superior a 256 caracteres.
Ocorreu uma exceção de configuração ao tentar criar e inicializar uma instância de um dos fornecedores de personalização configurados.
-ou-
O fornecedor de personalização padrão definido na configuração não foi encontrado.
O fornecedor padrão devolveu um número negativo para a contagem.
Observações
Este método devolve uma contagem do número de itens de personalização por utilizador no armazenamento de dados subjacente que existem para o dado usernameToMatch.
Note que o usernameToMatch parâmetro pode incluir caracteres coringa. Este método passa caracteres coringa para o armazenamento de dados subjacente. O suporte a caracteres curinga depende atualmente de como cada fornecedor lida com caracteres, como um asterisco (*), um símbolo percentual (%) ou um sublinhado (_).
Normalmente, para armazenamentos de dados compatíveis com SQL, uma pesquisa coringa num nome de utilizador parcial pode fazer com que o carácter curinga apareça em qualquer ponto da cadeia de texto da UsernameToMatch propriedade. Por exemplo, para encontrar todos os nomes de utilizador que começam por "John", o UsernameToMatch parâmetro seria "John%".
O usernameToMatch parâmetro pode ser null. Se definido como null, o parâmetro é ignorado ao realizar consultas. O parâmetro usernameToMatch pode ter vírgulas (,) porque alguns repositórios de dados, como os que correm Microsoft SQL Server, permitem vírgulas como caracteres coringa.