asp.net.ph

MembershipUserCollection Class

System.Web.Security Namespace


.NET Framework version 2.0

A collection of MembershipUser objects.

MembershipUserCollection Class Members

Collapse   Constructors

Visibility Constructor Parameters
public MembershipUserCollection ( )

Collapse   Properties

Visibility Name Value Type Accessibility
public Count Int32 [ Get ]
public IsSynchronized Boolean [ Get ]
public Item ( String name ) MembershipUser [ Get ]
public SyncRoot Object [ Get ]

Collapse   Methods

Visibility Name Parameters Return Type
public Add ( MembershipUser user ) Void
public Clear ( ) Void
public CopyTo ( MembershipUser array , Int32 index ) Void
public GetEnumerator ( ) IEnumerator
public Remove ( String name ) Void
public SetReadOnly ( ) Void

Remarks

A System.Web.Security.MembershipUserCollection is returned from the GetAllUsers, FindUsersByName, and FindUsersByEmail methods of the System.Web.Security.Membership class. The MembershipUserCollection objects returned by the GetAllUsers, FindUsersByName, and FindUsersByEmail methods contain a snapshot of user information in the membership data store. That is, changes to the membership user information in a MembershipUserCollection are not reflected in the membership data store. To modify membership user information in the membership data store, use the UpdateUser, CreateUser and DeleteUser methods of the System.Web.Security.Membership class.

Example

The following code example returns a list of membership users with a count of the number of users currently online. For an example of an ASP.NET application configured to use membership, see the Membership class.

Below is the HTML for the page.

<html>
<head>
   <title>Sample: Find Users</title>
</head>

<body>
<form 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 width=100>Page <asp:Label id = "CurrentPageLabel" runat = "server" />
               of <asp:Label id = "TotalPagesLabel" runat = "server" /></td>
            <td width=60><asp:LinkButton id = "PreviousButton" Text = "< Prev"
               OnClick = "PreviousButton_OnClick" runat = "server" /></td>
            <td 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>

Below is the code for the above page.

<%@ Page Language = "C#" %>
<%@ Import Namespace = "System.Web.Security" %>
<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, 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 src, EventArgs args ) {
   currentPage = Convert.ToInt32 ( CurrentPageLabel.Text );
   currentPage++;
   GetUsers ( );
}

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

</script>
  C# VB

See Also

Membership Class   MembershipUser Class Skip Navigation Links




Home
Suggested Reading


Previous page Back to top Next page

© 2000-2010 Rey Nuñez All rights reserved.

If you have any question, comment or suggestion
about this site, please send us a note

You can help support asp.net.ph