PersonalizationAdministration.FindInactiveUserState Método

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState(string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate);

static member FindInactiveUserState : string * string * DateTime -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime) As PersonalizationStateInfoCollection

Parâmetros

Retornos

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

Exceções

Comentários

Esse método retorna uma coleção de UserPersonalizationStateInfo instâncias, informações de estado de personalização por usuário em que o valor do pathToMatch parâmetro corresponde ao caminho de uma página, usernameToMatch corresponde a um nome de usuário que tem dados de personalização associados a essa página e os usuários são considerados inativos. Em outras palavras, para cada registro retornado, o valor da propriedade do LastActivityDate usuário é menor ou igual a userInactiveSinceDate. A coleção retornada contém apenas UserPersonalizationStateInfo instâncias.

Esse método passa caracteres curinga de consulta para o armazenamento de dados subjacente. Atualmente, o suporte para caracteres curinga depende de como cada provedor lida com caracteres como um asterisco (*), um símbolo percentual (%) 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 se pareceria com "John%".

Usando o provedor de personalização padrão, os PersonalizationStateInfoobjetos derivados 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.

Se userInactiveSinceDate for MaxValue, os valores retornados desse método serão equivalentes a FindUserState.

Ambos pathToMatch e usernameToMatch podem ser null. O usernameToMatch parâmetro pode incluir 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 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

public:
 static System::Web::UI::WebControls::WebParts::PersonalizationStateInfoCollection ^ FindInactiveUserState(System::String ^ pathToMatch, System::String ^ usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);

public static System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection FindInactiveUserState(string pathToMatch, string usernameToMatch, DateTime userInactiveSinceDate, int pageIndex, int pageSize, out int totalRecords);

static member FindInactiveUserState : string * string * DateTime * int * int * int -> System.Web.UI.WebControls.WebParts.PersonalizationStateInfoCollection

Public Shared Function FindInactiveUserState (pathToMatch As String, usernameToMatch As String, userInactiveSinceDate As DateTime, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As PersonalizationStateInfoCollection

Parâmetros

Retornos

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

Exceções

Comentários

Esse método retorna uma coleção de UserPersonalizationStateInfo instâncias, informações de estado de personalização por usuário em que o valor do pathToMatch parâmetro corresponde ao caminho de uma página, usernameToMatch corresponde a um nome de usuário que tem dados de personalização associados a essa página e os usuários são considerados inativos. Em outras palavras, para cada registro retornado, o valor da propriedade do LastActivityDate usuário é menor ou igual a userInactiveSinceDate. 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 manipula caracteres como um asterisco (*), um símbolo percentual (%) 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 se pareceria com "John%".

Usando o provedor de personalização padrão, os PersonalizationStateInfoobjetos derivados 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.

Se userInactiveSinceDate for MaxValue, os valores retornados desse método serão equivalentes a FindUserState.

Ambos pathToMatch e usernameToMatch podem 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 restringidos por pageIndex e, em pageIndex que os controles que registram para retornar e pageSize controla o número de registros a pageSizeserem retornados. Por exemplo, se pageIndex foi definido como 0 e pageSize foi definido como 25, os dados retornados seriam as primeiras 25 entradas. Se pageIndex foi definido como 1 e pageSize foi 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

• WebPartPersonalization
• controles de Web Parts 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