PersonalizationAdministration.FindUserState Método

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

Devoluções

A PersonalizationStateInfoCollection que contém informação de estado de personalização por utilizador.

Exceções

Exemplos

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

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.";
  }

}

Observações

Este método devolve uma coleção de UserPersonalizationStateInfo instâncias onde o pathToMatch valor do parâmetro corresponde ao caminho de uma página, e usernameToMatch corresponde a um nome de utilizador que tem dados de personalização associados a essa página. A coleção contém apenas UserPersonalizationStateInfo exemplos.

Este método passa caracteres curinga de parâmetros ao fornecedor de personalização subjacente, pelo que a forma como o armazenamento de dados lida com estes caracteres depende de como o fornecedor lida com caracteres como um asterisco (*), um símbolo percentual (%) ou um sublinhado (_).

Normalmente, para armazenamentos de dados compatíveis com SQL, pode realizar uma pesquisa coringa num caminho parcial, com o carácter curinga a aparecer no início, no fim ou no meio do texto da cadeia de pesquisa na PathToMatch propriedade. Por exemplo, para encontrar todos os caminhos que começam com "~/vdir", a PathToMatch propriedade seria definida como "~/vdir%".

Da mesma forma, 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", a UsernameToMatch propriedade pareceria "John%".

Usando o fornecedor de personalização por defeito, os PersonalizationStateInfoobjetos derivados em são devolvidos por ordem alfabética e ordenados por uma combinação de caminho e nome de utilizador em ordem crescente. A ordem dos objetos na coleção é determinada pelo fornecedor.

Tanto pathToMatch como podem usernameToMatch ser null. O parâmetro usernameToMatch pode ter vírgulas (,) porque alguns repositórios de dados, como os que executam Microsoft SQL Server, permitem vírgulas como caracteres curinga.

Ver também

• WebPartPersonalization
• ASP.NET Controlos de Web Parts
• Visão Geral da Personalização de Web Parts
• Guia: Implementar a Personalização de Web Parts com Controlo do Utilizador
• Personalização de Web Parts

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

Devoluções

A PersonalizationStateInfoCollection que contém informação de estado de personalização por utilizador.

Exceções

Exemplos

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

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.";
  }

}

Observações

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

Este método passa caracteres coringa de parâmetros para o fornecedor de personalização subjacente, pelo que a forma como o armazenamento de dados lida com estes caracteres depende de como o fornecedor trata caracteres como um asterisco (*), um símbolo percentual (%) ou um sublinhado (_).

Normalmente, para armazenamentos de dados compatíveis com SQL, pode realizar uma pesquisa coringa num caminho parcial, com o carácter curinga a aparecer no início, no fim ou no meio do texto da cadeia de pesquisa na PathToMatch propriedade. Por exemplo, para encontrar todos os caminhos que começam com "~/vdir", a PathToMatch propriedade seria definida como "~/vdir%".

Da mesma forma, 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", a UsernameToMatch propriedade pareceria "John%".

Usando o fornecedor de personalização por defeito, os PersonalizationStateInfoobjetos derivados em são devolvidos por ordem alfabética e ordenados por uma combinação de caminho e nome de utilizador em ordem crescente. A ordem dos objetos na coleção é determinada pelo fornecedor.

Tanto pathToMatch como podem usernameToMatch ser null. O parâmetro usernameToMatch pode ter vírgulas (,) porque alguns repositórios de dados, como os que executam Microsoft SQL Server, permitem vírgulas como caracteres curinga.

Os dados devolvidos são limitados por pageIndex e pageSize, onde pageIndex controla quais registos devolver e pageSize controla o número de registos a devolver. Por exemplo, se pageIndex estivesse definido para 0 e pageSize para 25, os dados devolvidos seriam as primeiras 25 entradas. Se pageIndex estivesse definido para 1 e pageSize definido para 25, os dados devolvidos seriam as entradas 26 a 50. O totalRecords parâmetro devolve o número total de registos disponíveis.

Ver também

• WebPartPersonalization
• ASP.NET Controlos de Web Parts
• Visão Geral da Personalização de Web Parts
• Guia: Implementar a Personalização de Web Parts com Controlo do Utilizador
• Personalização de Web Parts