MembershipUserCollection MembershipUserCollection MembershipUserCollection MembershipUserCollection Class

Definition

Eine Auflistung von MembershipUser-Objekten.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
Vererbung
MembershipUserCollectionMembershipUserCollectionMembershipUserCollectionMembershipUserCollection
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel gibt eine Liste der der Mitgliedschaftsbenutzer mit der Anzahl der Benutzer derzeit online.The following code example returns a list of membership users with a count of the number of users currently online. Ein Beispiel für eine ASP.NET-Anwendung so konfiguriert, dass die um Mitgliedschaft zu verwenden, finden Sie unter den Membership Klasse.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>

Hinweise

Ein System.Web.Security.MembershipUserCollection wird zurückgegeben, die GetAllUsers, FindUsersByName, und FindUsersByEmail Methoden der System.Web.Security.Membership Klasse.A System.Web.Security.MembershipUserCollection is returned from the GetAllUsers, FindUsersByName, and FindUsersByEmail methods of the System.Web.Security.Membership class. Die MembershipUserCollection zurückgegebenen Objekte die GetAllUsers, FindUsersByName, und FindUsersByEmail Methoden enthalten eine Momentaufnahme von Benutzerinformationen im Mitgliedschaftsdatenspeicher.The MembershipUserCollection objects returned by the GetAllUsers, FindUsersByName, and FindUsersByEmail methods contain a snapshot of user information in the membership data store. D. h., Änderungen an der Mitgliedschaftsbenutzerinformationen im eine MembershipUserCollection werden im Mitgliedschaftsdatenspeicher nicht wiedergegeben.That is, changes to the membership user information in a MembershipUserCollection are not reflected in the membership data store. Verwenden Sie zum Ändern der Mitgliedschaftsbenutzerinformationen im Mitgliedschaftsdatenspeicher der UpdateUser, CreateUser und DeleteUser Methoden der System.Web.Security.Membership Klasse.To modify membership user information in the membership data store, use the UpdateUser, CreateUser and DeleteUser methods of the System.Web.Security.Membership class.

Hinweis

Wenn Sie nicht mit den Mitgliedschaftsfunktionen von ASP.NET vertraut sind, finden Sie unter Einführung in die Mitgliedschaft vor dem fortfahren.If you are not familiar with the membership features of ASP.NET, see Introduction to Membership before continuing. Eine Liste weiterer Themen zur Mitgliedschaft, finden Sie unter Verwalten von Benutzern durch Mitgliedschaft.For a list of other topics related to membership, see Managing Users by Using Membership.

Konstruktoren

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

Erstellt eine neue, leere Mitgliedschaftsbenutzerauflistung.Creates a new, empty membership user collection.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Mitgliedschaftsbenutzerobjekte in der Auflistung ab.Gets the number of membership user objects in the collection.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ruft einen Wert ab, der angibt, ob die Mitgliedschaftsbenutzerauflistung threadsicher ist.Gets a value indicating whether the membership user collection is thread safe.

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

Ruft den Mitgliedschaftsbenutzer in der Auflistung ab, auf die vom angegebenen Benutzernamen verwiesen wird.Gets the membership user in the collection referenced by the specified user name.

SyncRoot SyncRoot SyncRoot SyncRoot

Ruft den Stamm der Synchronisierung ab.Gets the synchronization root.

Methoden

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

Fügt der Auflistung den angegebenen Mitgliedschaftsbenutzer hinzu.Adds the specified membership user to the collection.

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

Entfernt alle Mitgliedschaftsbenutzerobjekte aus der Auflistung.Removes all membership user objects from the collection.

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

Kopiert die Mitgliedschaftsbenutzerauflistung in ein eindimensionales Array.Copies the membership user collection to a one-dimensional array.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Gibt einen Enumerator zurück, der die Mitgliedschaftsbenutzerauflistung durchlaufen kann.Gets an enumerator that can iterate through the membership user collection.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Entfernt das Mitgliedschaftsbenutzerobjekt mit dem angegebenen Benutzernamen aus der Auflistung.Removes the membership user object with the specified user name from the collection.

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

Legt den Inhalt der Mitgliedschaftsbenutzerauflistung als schreibgeschützt fest.Makes the contents of the membership user collection read-only.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

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

Kopiert den Inhalt des MembershipUserCollection-Objekts in ein Array, wobei an einem bestimmten Array-Index begonnen wird.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)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

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

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

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

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

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

Konvertiert eine IEnumerable auf eine IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch