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

Devoluciones

PersonalizationStateInfoCollection que contiene la información de estado de personalización compartida.

Excepciones

Comentarios

Este método devuelve una colección de UserPersonalizationStateInfo instancias en las que el pathToMatch valor coincide con la ruta de acceso de una página que tiene datos de estado de personalización compartidos. La colección solo SharedPersonalizationStateInfo contiene instancias.

Este método pasa caracteres comodín de parámetro al proveedor de personalización subyacente, por lo que la forma en que el almacén de datos controla estos caracteres depende de cómo el proveedor controla caracteres como un asterisco (*), un símbolo de porcentaje (%) o un carácter de subrayado (_).

Normalmente, para los almacenes de datos compatibles con SQL, puede realizar una búsqueda con caracteres comodín en una ruta de acceso parcial con el carácter comodín que aparece al principio, el final o el medio del texto de la cadena de búsqueda en la PathToMatch propiedad . Por ejemplo, para buscar todas las rutas de acceso que comienzan por "~/vdir", la PathToMatch propiedad se establecería en "~/vdir%".

Con el proveedor de personalización predeterminado, los PersonalizationStateInfoobjetos derivados se devuelven en orden alfabético y se ordenan por una combinación de ruta de acceso y nombre de usuario en orden ascendente. El proveedor determina el orden de los objetos de la colección.

El pathToMatch parámetro puede ser null. Si se establece en null, se omite el parámetro al realizar consultas.

Consulte también

• WebPartPersonalization
• controles de elementos web de ASP.NET
• Información general sobre la personalización de elementos web
• Tutorial: Implementación de la personalización de elementos web con un control de usuario
• Personalización de elementos web

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

Devoluciones

PersonalizationStateInfoCollection que contiene la información de estado de personalización compartida.

Excepciones

Comentarios

Este método devuelve una colección de UserPersonalizationStateInfo instancias en las que el pathToMatch valor coincide con la ruta de acceso de una página que tiene datos de estado de personalización compartidos. La colección solo SharedPersonalizationStateInfo contiene instancias.

Este método pasa caracteres comodín de parámetro al proveedor de personalización subyacente, por lo que la forma en que el almacén de datos controla estos caracteres depende de cómo el proveedor controla caracteres como un asterisco (*), un símbolo de porcentaje (%) o un carácter de subrayado (_).

Normalmente, para los almacenes de datos compatibles con SQL, puede realizar una búsqueda con caracteres comodín en una ruta de acceso parcial con el carácter comodín que aparece al principio, el final o el medio del texto de la cadena de búsqueda en la PathToMatch propiedad . Por ejemplo, para buscar todas las rutas de acceso que comienzan por "~/vdir", la PathToMatch propiedad se establecería en "~/vdir%".

Con el proveedor de personalización predeterminado, los PersonalizationStateInfoobjetos derivados se devuelven en orden alfabético y se ordenan por una combinación de ruta de acceso y nombre de usuario en orden ascendente. El proveedor determina el orden de los objetos de la colección.

El pathToMatch parámetro puede ser null. Si se establece en null, se omite el parámetro al realizar consultas.

Los datos devueltos están restringidos por pageIndex y pageSize, donde pageIndex controla qué registros devolver y pageSize controla el número de registros que se van a devolver. Por ejemplo, si pageIndex se estableció en 0 y pageSize se estableció en 25, los datos devueltos serían las primeras 25 entradas. Si pageIndex se estableció en 1 y pageSize se estableció en 25, los datos devueltos serían entradas de 26 a 50. El totalRecords parámetro devuelve el número total de registros disponibles.

Consulte también

• WebPartPersonalization
• controles de elementos web de ASP.NET
• Información general sobre la personalización de elementos web
• Tutorial: Implementación de la personalización de elementos web con un control de usuario
• Personalización de elementos web