PersonalizationAdministration.FindInactiveUserState Método

Definição

Retorna uma coleção de informações de estado de personalização de cada usuário, para usuários inativos, de acordo com os parâmetros especificados.Returns a collection of per-user personalization state information for inactive users, based on the specified parameters.

Sobrecargas

FindInactiveUserState(String, String, DateTime)

Retorna uma coleção de informações de estado de personalização de cada usuário, para usuários inativos, de acordo com os parâmetros especificados.Returns a collection of per-user personalization state information for inactive users, based on the specified parameters.

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Retorna uma coleção de informações de estado de personalização de cada usuário, para usuários inativos, de acordo com os parâmetros especificados.Returns a collection of per-user personalization state information for inactive users, based on the specified parameters.

FindInactiveUserState(String, String, DateTime)

Retorna uma coleção de informações de estado de personalização de cada usuário, para usuários inativos, de acordo com os parâmetros especificados.Returns a collection of per-user personalization state information for inactive users, based on the specified parameters.

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

pathToMatch
String

O caminho da página para corresponder.The path of the page to match.

usernameToMatch
String

O nome de usuário para corresponder e que tem os dados de personalização associados com a página.The user name to match that has personalization data associated with the page.

userInactiveSinceDate
DateTime

A última data em que as informações de personalização de um usuário foram acessadas.The last date a user's personalization information was accessed.

Retornos

PersonalizationStateInfoCollection

Um PersonalizationStateInfoCollection que contém informações de estado de personalização de cada usuário.A PersonalizationStateInfoCollection that contains per-user personalization state information.

Exceções

pathToMatch ou usernameToMatch antes ou após a filtragem é uma cadeia de caracteres vazia ("").pathToMatch or usernameToMatch before or after trimming is an empty string ("").

- ou --or-

O provedor para um provedor de personalização definido na configuração não é do tipo correto.The provider for a personalization provider defined in configuration is not of the correct type.

- ou --or-

O comprimento da cadeia de caracteres de qualquer parâmetro é maior do que 256 caracteres.The length of the string of any parameter is greater than 256 characters.

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.A configuration exception occurred while attempting to create and initialize an instance of one of the configured personalization providers.

- ou --or-

Não foi possível encontrar o provedor de personalização padrão definido na configuração.The default personalization provider defined in configuration could not be found.

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 pathToMatch valor do 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.This method returns a collection of UserPersonalizationStateInfo instances, per-user personalization state information where the pathToMatch parameter value matches the path of a page, usernameToMatch matches a user name that has personalization data associated with that page, and the users are considered inactive. Em outras palavras, para cada registro retornado, o valor da Propriedade do usuário LastActivityDate é menor ou igual a userInactiveSinceDate .In other words, for each returned record the user's LastActivityDate property value is less than or equal to userInactiveSinceDate. A coleção retornada contém apenas UserPersonalizationStateInfo instâncias.The returned collection contains only UserPersonalizationStateInfo instances.

Esse método passa caracteres curinga de consulta para o armazenamento de dados subjacente.This method passes query wildcard characters to the underlying data store. No momento, o suporte para caracteres curinga depende de como cada provedor manipula caracteres como um asterisco (*), um símbolo de porcentagem (%) ou um sublinhado ().Support for wildcard characters is currently dependent on how each provider handles characters such as an asterisk (*), a percent symbol (%), or an underscore ().

Normalmente, para armazenamentos de dados compatíveis com SQL, você pode executar uma pesquisa de curinga em um caminho parcial com o caractere curinga que aparece no início, no final ou no meio do texto da cadeia de caracteres de pesquisa na PathToMatch propriedade.Normally, for SQL-compliant data stores, you can perform a wildcard search on a partial path with the wildcard character appearing at the beginning, the end, or the middle of the search string text in the PathToMatch property. Por exemplo, para localizar todos os caminhos que começam com " ~ /vdir", a PathToMatch propriedade seria definida como " ~ /vdir%".For example, to find all paths that start with "~/vdir", the PathToMatch property would be set to "~/vdir%".

Da mesma forma, uma pesquisa curinga em um nome de usuário parcial poderia ter o caractere curinga exibido em qualquer ponto na cadeia de texto da UsernameToMatch propriedade.Likewise, a wildcard search on a partial user name could have the wildcard character appear at any point in the text string of the UsernameToMatch property. Por exemplo, para localizar todos os nomes de usuário que começam com "John", a UsernameToMatch Propriedade ficaria como "João%".For example, to find all user names that start with "John", the UsernameToMatch property would look like "John%".

Usando o provedor de personalização padrão, os PersonalizationStateInfo objetos derivados são retornados em ordem alfabética e classificados por uma combinação de caminho e nome de usuário em ordem crescente.Using the default personalization provider, the PersonalizationStateInfo-derived objects are returned in alphabetical order, and sorted by a combination of path and user name in ascending order. A ordem dos objetos na coleção é determinada pelo provedor.The order of the objects in the collection is determined by the provider.

Se userInactiveSinceDate for MaxValue , os valores retornados desse método serão equivalentes a FindUserState .If userInactiveSinceDate is MaxValue, then the returned values from this method are equivalent to FindUserState.

Ambos pathToMatch e usernameToMatch podem ser null .Both pathToMatch and usernameToMatch can be null. O usernameToMatch parâmetro pode incluir vírgulas (,) porque alguns armazenamentos de dados, como aqueles em execução Microsoft SQL Server, permitem vírgulas como caracteres curinga.The usernameToMatch parameter can include commas (,) because some data stores, such as those running Microsoft SQL Server, allow commas as wildcard characters.

Confira também

Aplica-se a

FindInactiveUserState(String, String, DateTime, Int32, Int32, Int32)

Retorna uma coleção de informações de estado de personalização de cada usuário, para usuários inativos, de acordo com os parâmetros especificados.Returns a collection of per-user personalization state information for inactive users, based on the specified parameters.

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

pathToMatch
String

O caminho da página para corresponder.The path of the page to match.

usernameToMatch
String

O nome de usuário para corresponder e que tem os dados de personalização associados com a página.The user name to match that has personalization data associated with the page.

userInactiveSinceDate
DateTime

A última data em que as informações de personalização foram acessadas.The last date personalization information was accessed.

pageIndex
Int32

O índice com base em zero da página de resultados a serem retornados.The zero-based index of the page of results to return.

pageSize
Int32

O número de registros a serem retornados.The number of records to return.

totalRecords
Int32

O número total de registros disponíveis.The total number of records available.

Retornos

PersonalizationStateInfoCollection

Um PersonalizationStateInfoCollection que contém informações de estado de personalização de cada usuário.A PersonalizationStateInfoCollection that contains per-user personalization state information.

Exceções

pathToMatch ou usernameToMatch antes ou após a filtragem é uma cadeia de caracteres vazia ("").pathToMatch or usernameToMatch before or after trimming is an empty string ("").

- ou --or-

pageIndex é menor que zeropageIndex is less than zero

- ou --or-

pageSize é menor que ou igual a zero.pageSize is less than or equal to zero.

- ou --or-

a combinação de pageIndex e pageSize excede MaxValue.the combination of pageIndex and pageSize exceeds MaxValue.

- ou --or-

O provedor para um provedor de personalização definido na configuração não é do tipo correto.The provider for a personalization provider defined in configuration is not of the correct type.

- ou --or-

O comprimento da cadeia de caracteres de qualquer parâmetro é maior do que 256 caracteres.The length of the string of any parameter is greater than 256 characters.

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.A configuration exception occurred while attempting to create and initialize an instance of one of the configured personalization providers.

- ou --or-

Não foi possível encontrar o provedor de personalização padrão definido na configuração.The default personalization provider defined in configuration could not be found.

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 pathToMatch valor do 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.This method returns a collection of UserPersonalizationStateInfo instances, per-user personalization state information where the pathToMatch parameter value matches the path of a page, usernameToMatch matches a user name that has personalization data associated with that page, and the users are considered inactive. Em outras palavras, para cada registro retornado, o valor da Propriedade do usuário LastActivityDate é menor ou igual a userInactiveSinceDate .In other words, for each returned record the user's LastActivityDate property value is less than or equal to userInactiveSinceDate. A coleção contém apenas UserPersonalizationStateInfo instâncias.The collection contains only UserPersonalizationStateInfo instances.

Esse método passa caracteres curinga de parâmetro para o provedor de personalização subjacente, de modo que 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 ().This method passes parameter wildcard characters to the underlying personalization provider, so how the data store handles these characters depends on how the provider handles characters such as an asterisk (*), a percent symbol (%), or an underscore ().

Normalmente, para armazenamentos de dados compatíveis com SQL, você pode executar uma pesquisa de curinga em um caminho parcial com o caractere curinga que aparece no início, no final ou no meio do texto da cadeia de caracteres de pesquisa na PathToMatch propriedade.Normally, for SQL-compliant data stores, you can perform a wildcard search on a partial path with the wildcard character appearing at the beginning, the end, or the middle of the search string text in the PathToMatch property. Por exemplo, para localizar todos os caminhos que começam com " ~ /vdir", a PathToMatch propriedade seria definida como " ~ /vdir%".For example, to find all paths that start with "~/vdir", the PathToMatch property would be set to "~/vdir%".

Da mesma forma, uma pesquisa curinga em um nome de usuário parcial poderia ter o caractere curinga exibido em qualquer ponto na cadeia de texto da UsernameToMatch propriedade.Likewise, a wildcard search on a partial user name could have the wildcard character appear at any point in the text string of the UsernameToMatch property. Por exemplo, para localizar todos os nomes de usuário que começam com "John", a UsernameToMatch Propriedade ficaria como "João%".For example, to find all user names that start with "John", the UsernameToMatch property would look like "John%".

Usando o provedor de personalização padrão, os PersonalizationStateInfo objetos derivados são retornados em ordem alfabética e classificados por uma combinação de caminho e nome de usuário em ordem crescente.Using the default personalization provider, the PersonalizationStateInfo-derived objects are returned in alphabetical order, and sorted by a combination of path and user name in ascending order. A ordem dos objetos na coleção é determinada pelo provedor.The order of the objects in the collection is determined by the provider.

Se userInactiveSinceDate for MaxValue , os valores retornados desse método serão equivalentes a FindUserState .If userInactiveSinceDate is MaxValue, then the returned values from this method are equivalent to FindUserState.

Ambos pathToMatch e usernameToMatch podem ser null .Both pathToMatch and usernameToMatch can be null. O usernameToMatch parâmetro pode ter vírgulas (,) porque alguns armazenamentos de dados, como aqueles em execução Microsoft SQL Server, permitem vírgulas como caracteres curinga.The usernameToMatch parameter can have commas (,) because some data stores, such as those running Microsoft SQL Server, allow commas as wildcard characters.

Os dados retornados são restritos por pageIndex e pageSize , onde pageIndex controla quais registros retornam e pageSize controlam o número de registros a serem retornados.The data returned is constrained by pageIndex and pageSize, where pageIndex controls which records to return and pageSize controls the number of records to return. Por exemplo, se pageIndex foi definido como 0 e pageSize foi definido como 25, os dados retornados seriam as 25 primeiras entradas.For example, if pageIndex was set to 0 and pageSize was set to 25, the data returned would be the first 25 entries. Se pageIndex foi definido como 1 e pageSize foi definido como 25, os dados retornados seriam entradas 26 a 50.If pageIndex was set to 1 and pageSize was set to 25, the data returned would be entries 26 to 50. O totalRecords parâmetro retorna o número total de registros que estão disponíveis.The totalRecords parameter returns the total number of records that are available.

Confira também

Aplica-se a