PersonalizationAdministration.GetCountOfUserState(String) Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

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

Int32

O número de itens de estado de personalização para o usuário especificado.

Exceções

ArgumentException

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.

ConfigurationErrorsException

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.

HttpException

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.

Confira também

• WebPartPersonalization
• Controles de Web Parts do ASP.NET
• Visão geral da personalização de Web Parts
• Passo a passo: implementando a personalização de Web Parts com um controle de usuário
• Personalização de Web Parts