Compartilhar via

PersonalizationAdministration.FindSharedState Método

Definição

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

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

Sobrecargas

Nome Description
FindSharedState(String)

Retorna uma coleção de informações de estado de personalização compartilhadas com base no caminho especificado.
FindSharedState(String, Int32, Int32, Int32)

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

FindSharedState(String)

Retorna uma coleção de informações de estado de personalização compartilhadas com base no caminho especificado.

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

Parâmetros

pathToMatch
String

O caminho da página a ser correspondida.

Retornos

PersonalizationStateInfoCollection

Um PersonalizationStateInfoCollection que contém informações de estado de personalização compartilhadas.

Exceções

ArgumentException

pathToMatch é uma cadeia de caracteres vazia ("") antes ou depois do corte.

- ou -

O provedor de 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 que 256 caracteres.

ConfigurationErrorsException

Ocorreu uma exceção de configuração ao tentar 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.

Comentários

Esse método retorna uma coleção de UserPersonalizationStateInfo instâncias em que o pathToMatch valor corresponde ao caminho de uma página que tem dados de estado de personalização compartilhados. A coleção contém apenas SharedPersonalizationStateInfo 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%".

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 ordenação dos objetos na coleção é determinada pelo provedor.

O pathToMatch parâmetro pode ser null. Se definido como null, o parâmetro será ignorado ao executar consultas.

Confira também

Aplica-se a

FindSharedState(String, Int32, Int32, Int32)

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

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

Parâmetros

pathToMatch
String

O caminho da página a ser correspondida.

pageIndex
Int32

O índice baseado em zero da página de resultados a ser retornado.

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

Exceções

ArgumentException

pathToMatch antes ou depois do corte é uma cadeia de caracteres vazia ("").

- ou -

pageIndex é menor que zero.

- ou -

pageSize é menor ou igual a zero.

- ou -

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

- ou -

O provedor de 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 que 256 caracteres.

ConfigurationErrorsException

Ocorreu uma exceção de configuração ao tentar 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.

Comentários

Esse método retorna uma coleção de UserPersonalizationStateInfo instâncias em que o pathToMatch valor corresponde ao caminho de uma página que tem dados de estado de personalização compartilhados. A coleção contém apenas SharedPersonalizationStateInfo 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%".

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.

O pathToMatch parâmetro pode ser null. Se definido como null, o parâmetro será ignorado ao executar consultas.

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

Aplica-se a