Compartilhar via

PersonalizationAdministration.FindUserState Método

  • Referência

Definição

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Retorna uma coleção de informações de estado de personalização de cada usuário com base nos parâmetros especificados.

Sobrecargas

FindUserState(String, String)

Retorna uma coleção de informações de estado de personalização de cada usuário com base no nome de usuário e caminho de página.
FindUserState(String, String, Int32, Int32, Int32)

Retorna uma coleção de informações de estado de personalização de cada usuário com base nos parâmetros especificados.

FindUserState(String, String)

Retorna uma coleção de informações de estado de personalização de cada usuário com base no nome de usuário e caminho de página.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch);
static member FindUserState : string * string -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String) As PersonalizationStateInfoCollection

Parâmetros

pathToMatch
String

O caminho da página para corresponder.

usernameToMatch
String

O nome de usuário para corresponder e que tem os dados de personalização associados com a página.

Retornos

PersonalizationStateInfoCollection

Um PersonalizationStateInfoCollection que contém informações de estado de personalização de cada usuário.

Exceções

ArgumentException

pathToMatch ou usernameToMatch antes ou após a filtragem é uma cadeia de caracteres vazia ("").

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

Exemplos

O exemplo de código a seguir demonstra como usar o FindUserState método . O exemplo completo pode ser encontrado no tópico de visão geral da PersonalizationAdministration classe.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

Comentários

Esse método retorna uma coleção de UserPersonalizationStateInfo instâncias em que o valor do pathToMatch parâmetro corresponde ao caminho de uma página e usernameToMatch corresponde a um nome de usuário que tem dados de personalização associados a essa página. A coleção contém apenas UserPersonalizationStateInfo instâncias.

Esse método passa caracteres curinga de parâmetro para o provedor de personalização subjacente, portanto, a forma como o armazenamento de dados manipula esses caracteres depende de como o provedor lida com caracteres como um asterisco (*), um símbolo de porcentagem (%) ou um sublinhado (_).

Normalmente, para armazenamentos de dados em conformidade com SQL, você pode executar uma pesquisa curinga em um caminho parcial com o caractere curinga aparecendo no início, no final ou no meio do texto da cadeia de caracteres de pesquisa na PathToMatch propriedade . Por exemplo, para localizar todos os caminhos que começam com "~/vdir", a PathToMatch propriedade seria definida como "~/vdir%".

Da mesma forma, uma pesquisa curinga em um nome de usuário parcial pode fazer com que o caractere curinga apareça a qualquer momento na cadeia de caracteres de texto da UsernameToMatch propriedade. Por exemplo, para localizar todos os nomes de usuário que começam com "John", a UsernameToMatch propriedade seria semelhante a "John%".

Usando o provedor de personalização padrão, os PersonalizationStateInfoobjetos derivados de são retornados em ordem alfabética e classificados por uma combinação de caminho e nome de usuário em ordem crescente. A ordenação dos objetos na coleção é determinada pelo provedor.

usernameToMatch E pathToMatch pode ser null. O usernameToMatch parâmetro pode 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

Aplica-se a

FindUserState(String, String, Int32, Int32, Int32)

Retorna uma coleção de informações de estado de personalização de cada usuário com base nos parâmetros especificados.

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindUserState (string pathToMatch, string usernameToMatch, int pageIndex, int pageSize, out int totalRecords);
static member FindUserState : string * string * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection
Public Shared Function FindUserState (pathToMatch As String, usernameToMatch As String, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parâmetros

pathToMatch
String

O caminho da página para corresponder.

usernameToMatch
String

O nome de usuário para corresponder e que tem os dados de personalização associados com a página.

pageIndex
Int32

O índice com base em zero da página de resultados a serem retornados.

pageSize
Int32

O número de registros a serem retornados.

totalRecords
Int32

O número total de registros disponíveis.

Retornos

PersonalizationStateInfoCollection

Um PersonalizationStateInfoCollection que contém informações de estado de personalização de cada usuário.

Exceções

ArgumentException

pathToMatch ou usernameToMatch antes ou após a filtragem é uma cadeia de caracteres vazia ("").

- ou -

pageIndex é menor que zero.

- ou -

pageSize é menor que ou igual a zero.

- ou -

A combinação de pageIndex e pageSize excede Int32.MaxValue.

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

Exemplos

O exemplo de código a seguir demonstra como usar o FindUserState método . O exemplo completo pode ser encontrado no tópico de visão geral da PersonalizationAdministration classe.

Importante

Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos HTML ou script. Para obter mais informações, consulte Visão geral de explorações de script.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

Comentários

Esse método retorna uma coleção de UserPersonalizationStateInfo instâncias em que o valor do pathToMatch parâmetro corresponde ao caminho de uma página e usernameToMatch corresponde a um nome de usuário que tem dados de personalização associados a essa página. A coleção contém apenas UserPersonalizationStateInfo instâncias.

Esse método passa caracteres curinga de parâmetro para o provedor de personalização subjacente, portanto, como o armazenamento de dados manipula esses caracteres depende de como o provedor manipula caracteres como um asterisco (*), um símbolo de porcentagem (%) ou um sublinhado (_).

Normalmente, para armazenamentos de dados em conformidade com SQL, você pode executar uma pesquisa curinga em um caminho parcial com o caractere curinga aparecendo no início, no final ou no meio do texto da cadeia de caracteres de pesquisa na PathToMatch propriedade . Por exemplo, para localizar todos os caminhos que começam com "~/vdir", a PathToMatch propriedade seria definida como "~/vdir%".

Da mesma forma, uma pesquisa curinga em um nome de usuário parcial pode fazer com que o caractere curinga apareça a qualquer momento na cadeia de caracteres de texto da UsernameToMatch propriedade. Por exemplo, para localizar todos os nomes de usuário que começam com "John", a UsernameToMatch propriedade seria semelhante a "John%".

Usando o provedor de personalização padrão, os PersonalizationStateInfoobjetos derivados de são retornados em ordem alfabética e classificados por uma combinação de caminho e nome de usuário em ordem crescente. A ordem dos objetos na coleção é determinada pelo provedor.

usernameToMatch E pathToMatch pode ser null. O usernameToMatch parâmetro pode ter vírgulas (,) porque alguns armazenamentos de dados, como aqueles que executam o Microsoft SQL Server, permitem vírgulas como caracteres curinga.

Os dados retornados são restritos por pageIndex e , em pageIndex que controla quais registros retornar e pageSize controla o número de registros a pageSizeserem retornados. Por exemplo, se pageIndex fosse definido como 0 e pageSize fosse definido como 25, os dados retornados seriam as primeiras 25 entradas. Se pageIndex fosse definido como 1 e pageSize fosse definido como 25, os dados retornados seriam entradas de 26 a 50. O totalRecords parâmetro retorna o número total de registros disponíveis.

Confira também

Aplica-se a