MembershipUserCollection MembershipUserCollection MembershipUserCollection MembershipUserCollection Class

Definición

Una colección de objetos MembershipUser.A collection of MembershipUser objects.

public ref class MembershipUserCollection sealed : System::Collections::ICollection
[System.Serializable]
public sealed class MembershipUserCollection : System.Collections.ICollection
type MembershipUserCollection = class
    interface IEnumerable
    interface ICollection
Public NotInheritable Class MembershipUserCollection
Implements ICollection
Herencia
MembershipUserCollectionMembershipUserCollectionMembershipUserCollectionMembershipUserCollection
Atributos
Implementaciones

Ejemplos

En el ejemplo de código siguiente se devuelve una lista de usuarios de pertenencia con un recuento del número de usuarios en línea actualmente.The following code example returns a list of membership users with a count of the number of users currently online. Para obtener un ejemplo de una aplicación ASP.NET configurada para utilizar la suscripción, consulte el Membership clase.For an example of an ASP.NET application configured to use membership, see the Membership class.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

int pageSize = 5;
int totalUsers;
int totalPages;
int currentPage = 1;

public void Page_Load()
{
  if (!IsPostBack)
  {
    GetUsers();
  }
}

private void GetUsers()
{
  UsersOnlineLabel.Text = Membership.GetNumberOfUsersOnline().ToString();

  UserGrid.DataSource = Membership.GetAllUsers(currentPage-1, pageSize, out totalUsers);
  totalPages = ((totalUsers - 1) / pageSize) + 1;

  // Ensure that we do not navigate past the last page of users.

  if (currentPage > totalPages)
  {
    currentPage = totalPages;
    GetUsers();
    return;
  }

  UserGrid.DataBind();
  CurrentPageLabel.Text = currentPage.ToString();
  TotalPagesLabel.Text = totalPages.ToString();

  if (currentPage == totalPages)
    NextButton.Visible = false;
  else
    NextButton.Visible = true;

  if (currentPage == 1)
    PreviousButton.Visible = false;
  else
    PreviousButton.Visible = true;

  if (totalUsers <= 0)
    NavigationPanel.Visible = false;
  else
    NavigationPanel.Visible = true;
}

public void NextButton_OnClick(object sender, EventArgs args)
{
  currentPage = Convert.ToInt32(CurrentPageLabel.Text);
  currentPage++;
  GetUsers();
}

public void PreviousButton_OnClick(object sender, EventArgs args)
{
  currentPage = Convert.ToInt32(CurrentPageLabel.Text);
  currentPage--;
  GetUsers();
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Find Users</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>User List</h3>

  Number of Users Online: <asp:Label id="UsersOnlineLabel" runat="Server" /><br />

  <asp:Panel id="NavigationPanel" Visible="false" runat="server">
    <table border="0" cellpadding="3" cellspacing="3">
      <tr>
        <td style="width:100">Page <asp:Label id="CurrentPageLabel" runat="server" />
            of <asp:Label id="TotalPagesLabel" runat="server" /></td>
        <td style="width:60"><asp:LinkButton id="PreviousButton" Text="< Prev"
                            OnClick="PreviousButton_OnClick" runat="server" /></td>
        <td style="width:60"><asp:LinkButton id="NextButton" Text="Next >"
                            OnClick="NextButton_OnClick" runat="server" /></td>
      </tr>
    </table>
  </asp:Panel>

  <asp:DataGrid id="UserGrid" runat="server"
                CellPadding="2" CellSpacing="1"
                Gridlines="Both">
    <HeaderStyle BackColor="darkblue" ForeColor="white" />
  </asp:DataGrid>

</form>

</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Security" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

Dim pageSize As Integer = 5
Dim totalUsers As Integer
Dim totalPages As Integer
    Dim currentPage As Integer = 1

Public Sub Page_Load()
  If Not IsPostBack Then
    GetUsers()
  End If
End Sub

Private Sub GetUsers()
  UsersOnlineLabel.Text = Membership.GetNumberOfUsersOnline().ToString()

  UserGrid.DataSource = Membership.GetAllUsers(currentPage-1, pageSize, totalUsers)
  totalPages = ((totalUsers - 1) \ pageSize) + 1

  ' Ensure that we do not navigate past the last page of users.

  If currentPage > totalPages Then
    currentPage = totalPages
    GetUsers()
    Return
  End If

  UserGrid.DataBind()
  CurrentPageLabel.Text = currentPage.ToString()
  TotalPagesLabel.Text = totalPages.ToString()

  If currentPage = totalPages Then
    NextButton.Visible = False
  Else
    NextButton.Visible = True
  End If

  If currentPage = 1 Then
    PreviousButton.Visible = False
  Else
    PreviousButton.Visible = True
  End If

  If totalUsers <= 0 Then
    NavigationPanel.Visible = False
  Else
    NavigationPanel.Visible = True
  End If
End SUb

Public Sub NextButton_OnClick(sender As Object, args As EventArgs)
  currentPage = Convert.ToInt32(CurrentPageLabel.Text)
  currentPage += 1
  GetUsers()
End Sub

Public Sub PreviousButton_OnClick(sender As Object, args As EventArgs)
  currentPage = Convert.ToInt32(CurrentPageLabel.Text)
  currentPage -= 1
  GetUsers()
End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Find Users</title>
</head>
<body>

<form id="form1" runat="server">
  <h3>User List</h3>

  Number of Users Online: <asp:Label id="UsersOnlineLabel" runat="Server" /><br />

  <asp:Panel id="NavigationPanel" Visible="false" runat="server">
    <table border="0" cellpadding="3" cellspacing="3">
      <tr>
        <td style="width:100">Page <asp:Label id="CurrentPageLabel" runat="server" />
            of <asp:Label id="TotalPagesLabel" runat="server" /></td>
        <td style="width:60"><asp:LinkButton id="PreviousButton" Text="< Prev"
                            OnClick="PreviousButton_OnClick" runat="server" /></td>
        <td style="width:60"><asp:LinkButton id="NextButton" Text="Next >"
                            OnClick="NextButton_OnClick" runat="server" /></td>
      </tr>
    </table>
  </asp:Panel>

  <asp:DataGrid id="UserGrid" runat="server"
                CellPadding="2" CellSpacing="1"
                Gridlines="Both">
    <HeaderStyle BackColor="darkblue" ForeColor="white" />
  </asp:DataGrid>

</form>

</body>
</html>

Comentarios

Un System.Web.Security.MembershipUserCollection se devuelve desde el GetAllUsers, FindUsersByName, y FindUsersByEmail métodos de la System.Web.Security.Membership clase.A System.Web.Security.MembershipUserCollection is returned from the GetAllUsers, FindUsersByName, and FindUsersByEmail methods of the System.Web.Security.Membership class. El MembershipUserCollection los objetos devueltos por la GetAllUsers, FindUsersByName, y FindUsersByEmail métodos contienen una instantánea de la información de usuario en el almacén de datos de pertenencia.The MembershipUserCollection objects returned by the GetAllUsers, FindUsersByName, and FindUsersByEmail methods contain a snapshot of user information in the membership data store. Es decir, cambia a la información de usuario de pertenencia en un MembershipUserCollection no se reflejan en el almacén de datos de pertenencia.That is, changes to the membership user information in a MembershipUserCollection are not reflected in the membership data store. Para modificar la información de usuario de pertenencia en el almacén de datos de suscripción, utilice el UpdateUser, CreateUser y DeleteUser métodos de la System.Web.Security.Membership clase.To modify membership user information in the membership data store, use the UpdateUser, CreateUser and DeleteUser methods of the System.Web.Security.Membership class.

Nota

Si no está familiarizado con las características de pertenencia de ASP.NET, consulte Introducción a la suscripción antes de continuar.If you are not familiar with the membership features of ASP.NET, see Introduction to Membership before continuing. Para obtener una lista de otros temas relacionados con la pertenencia, vea administrar usuarios mediante pertenencia.For a list of other topics related to membership, see Managing Users by Using Membership.

Constructores

MembershipUserCollection() MembershipUserCollection() MembershipUserCollection() MembershipUserCollection()

Crea una nueva colección vacía de usuarios de pertenencia.Creates a new, empty membership user collection.

Propiedades

Count Count Count Count

Obtiene el número de objetos de usuario de pertenencia de la colección.Gets the number of membership user objects in the collection.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Obtiene un valor que indica si la colección de usuarios de pertenencia es segura para subprocesos.Gets a value indicating whether the membership user collection is thread safe.

Item[String] Item[String] Item[String] Item[String]

Obtiene el usuario de pertenencia de la colección a que hace referencia el nombre de usuario especificado.Gets the membership user in the collection referenced by the specified user name.

SyncRoot SyncRoot SyncRoot SyncRoot

Obtiene la raíz de sincronización.Gets the synchronization root.

Métodos

Add(MembershipUser) Add(MembershipUser) Add(MembershipUser) Add(MembershipUser)

Agrega el usuario de pertenencia especificado a la colección.Adds the specified membership user to the collection.

Clear() Clear() Clear() Clear()

Quita todos los objetos de usuario de miembro de la colección.Removes all membership user objects from the collection.

CopyTo(MembershipUser[], Int32) CopyTo(MembershipUser[], Int32) CopyTo(MembershipUser[], Int32) CopyTo(MembershipUser[], Int32)

Copia la colección de usuarios de pertenencia en una matriz unidimensional.Copies the membership user collection to a one-dimensional array.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Obtiene un enumerador que puede recorrer en iteración la colección de usuarios de pertenencia.Gets an enumerator that can iterate through the membership user collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(String) Remove(String) Remove(String) Remove(String)

Quita el objeto de usuario de pertenencia con el nombre especificado de la colección.Removes the membership user object with the specified user name from the collection.

SetReadOnly() SetReadOnly() SetReadOnly() SetReadOnly()

Hace que el contenido de la colección de usuarios de pertenencia sea de sólo lectura.Makes the contents of the membership user collection read-only.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32) ICollection.CopyTo(Array, Int32)

Copia el contenido del objeto MembershipUserCollection en una matriz Array, a partir de un índice determinado de Array.Copies the contents of the MembershipUserCollection object to an Array, starting at a particular Array index.

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Convierte los elementos de un IEnumerable al tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a

Consulte también: