PersonalizationAdministration.FindSharedState Método

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

Devoluções

A que contém informação partilhada PersonalizationStateInfoCollection do estado de personalização.

Exceções

Observações

Este método devolve 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 partilhados. A coleção contém apenas SharedPersonalizationStateInfo 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%".

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.

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

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

Devoluções

A que contém informação partilhada PersonalizationStateInfoCollection do estado de personalização.

Exceções

Observações

Este método devolve 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 partilhados. A coleção contém apenas SharedPersonalizationStateInfo 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%".

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.

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

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