Compartilhar via


PersonalizationAdministration.GetCountOfUserState(String) Método

Definição

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 -> int
Public Shared Function GetCountOfUserState (usernameToMatch As String) As Integer

Parâ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.

Aplica-se a

Confira também