Compartir a través de


PersonalizationAdministration.FindUserState Método

Definición

Devuelve una colección de información de estado de personalización por usuario, en función de los parámetros especificados.

Sobrecargas

FindUserState(String, String)

Devuelve una colección de información de estado de personalización por usuario, basada en el nombre de usuario y la ruta de acceso de la página.

FindUserState(String, String, Int32, Int32, Int32)

Devuelve una colección de información de estado de personalización por usuario, en función de los parámetros especificados.

FindUserState(String, String)

Devuelve una colección de información de estado de personalización por usuario, basada en el nombre de usuario y la ruta de acceso de la página.

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

Parámetros

pathToMatch
String

Ruta de acceso de la página que debe coincidir.

usernameToMatch
String

Nombre de usuario que debe coincidir y que tiene datos de personalización asociados a la página.

Devoluciones

Clase PersonalizationStateInfoCollection que contiene la información de estado de personalización por usuario.

Excepciones

pathToMatch o usernameToMatch antes o después de recortar es una cadena vacía ("").

o bien

El proveedor de un proveedor de personalización definido en la configuración no es del tipo correcto.

o bien

La longitud de la cadena de cualquier parámetro tiene más de 256 caracteres.

Se ha producido una excepción de configuración cuando se intentaba crear e inicializar una instancia de uno de los proveedores de personalización configurados.

o bien

No se encuentra el proveedor de personalización predeterminado definido en la configuración.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método FindUserState. El ejemplo completo se puede encontrar en el tema de información general de la PersonalizationAdministration clase.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

Comentarios

Este método devuelve una colección de UserPersonalizationStateInfo instancias en las que el valor del pathToMatch parámetro coincide con la ruta de acceso de una página y usernameToMatch coincide con un nombre de usuario que tiene datos de personalización asociados a esa página. La colección solo UserPersonalizationStateInfo contiene instancias.

Este método pasa caracteres comodín de parámetro al proveedor de personalización subyacente, por lo que el modo en que el almacén de datos controla estos caracteres depende de cómo el proveedor controla los 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%".

Del mismo modo, una búsqueda con caracteres comodín en un nombre de usuario parcial podría hacer que el carácter comodín aparezca en cualquier punto de la cadena de texto de la UsernameToMatch propiedad. Por ejemplo, para buscar todos los nombres de usuario que comienzan por "John", la UsernameToMatch propiedad tendría un aspecto similar a "John%".

Con el proveedor de personalización predeterminado, los PersonalizationStateInfoobjetos derivados de 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.

Tanto pathToMatch como usernameToMatch pueden ser null. El usernameToMatch parámetro puede tener comas (,) porque algunos almacenes de datos, como los que ejecutan Microsoft SQL Server, permiten comas como caracteres comodín.

Consulte también

Se aplica a

FindUserState(String, String, Int32, Int32, Int32)

Devuelve una colección de información de estado de personalización por usuario, en función de los parámetros especificados.

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

Parámetros

pathToMatch
String

Ruta de acceso de la página que debe coincidir.

usernameToMatch
String

Nombre de usuario que debe coincidir y que tiene datos de personalización asociados a la página.

pageIndex
Int32

Índice de base cero de la página de resultados que se va a devolver.

pageSize
Int32

Número de registros que se van a devolver.

totalRecords
Int32

Número total o registros disponibles.

Devoluciones

Clase PersonalizationStateInfoCollection que contiene la información de estado de personalización por usuario.

Excepciones

pathToMatch o usernameToMatch antes o después de recortar es una cadena vacía ("").

o bien

pageIndex es menor que cero.

O bien

pageSize es menor o igual que cero.

o bien

La combinación de pageIndex y pageSize supera Int32.MaxValue.

o bien

El proveedor de un proveedor de personalización definido en la configuración no es del tipo correcto.

o bien

La longitud de la cadena de cualquier parámetro tiene más de 256 caracteres.

Se ha producido una excepción de configuración cuando se intentaba crear e inicializar una instancia de uno de los proveedores de personalización configurados.

o bien

No se encuentra el proveedor de personalización predeterminado definido en la configuración.

Ejemplos

En el ejemplo de código siguiente se muestra cómo utilizar el método FindUserState. El ejemplo completo se puede encontrar en el tema de información general de la PersonalizationAdministration clase.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script. Para más información, consulte Información general sobre los ataques mediante scripts.

protected void Button1_Click(object sender, EventArgs e)
{
    if (TextBox3.Text != null)
    {
        PersonalizationStateInfoCollection findresult;
      findresult = PersonalizationAdministration.FindUserState(null, TextBox3.Text);
      if (findresult.Count != 0)
      {
          Label4.Text = findresult.Count + "  user(s) found";
          Label4.Visible = true;
      }
      else
      {
          Label4.Text = "No users found.";
          Label4.Visible = true;
      }
    }
  else
  {
      Label4.Text = "You must enter a user name to find.";
  }

}

Comentarios

Este método devuelve una colección de UserPersonalizationStateInfo instancias en las que el valor del pathToMatch parámetro coincide con la ruta de acceso de una página y usernameToMatch coincide con un nombre de usuario que tiene datos de personalización asociados a esa página. La colección solo UserPersonalizationStateInfo contiene instancias.

Este método pasa caracteres comodín de parámetro al proveedor de personalización subyacente, por lo que el modo en que el almacén de datos controla estos caracteres depende de cómo el proveedor controla los 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%".

Del mismo modo, una búsqueda con caracteres comodín en un nombre de usuario parcial podría hacer que el carácter comodín aparezca en cualquier punto de la cadena de texto de la UsernameToMatch propiedad. Por ejemplo, para buscar todos los nombres de usuario que comienzan por "John", la UsernameToMatch propiedad tendría un aspecto similar a "John%".

Con el proveedor de personalización predeterminado, los PersonalizationStateInfoobjetos derivados de 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.

Tanto pathToMatch como usernameToMatch pueden ser null. El usernameToMatch parámetro puede tener comas (,) porque algunos almacenes de datos, como los que ejecutan Microsoft SQL Server, permiten comas como caracteres comodín.

Los datos devueltos están restringidos por pageIndex y pageSize, donde pageIndex controla los registros que se van a 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 25 primeras 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

Se aplica a