ProfileManager.GetAllProfiles Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft Benutzerprofildaten für Profile in der Datenquelle ab.
Überlädt
GetAllProfiles(ProfileAuthenticationOption) |
Ruft Benutzerprofildaten für Profile in der Datenquelle ab. |
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32) |
Ruft Seiten von Benutzerprofildaten ab. |
GetAllProfiles(ProfileAuthenticationOption)
Ruft Benutzerprofildaten für Profile in der Datenquelle ab.
public:
static System::Web::Profile::ProfileInfoCollection ^ GetAllProfiles(System::Web::Profile::ProfileAuthenticationOption authenticationOption);
public static System.Web.Profile.ProfileInfoCollection GetAllProfiles (System.Web.Profile.ProfileAuthenticationOption authenticationOption);
static member GetAllProfiles : System.Web.Profile.ProfileAuthenticationOption -> System.Web.Profile.ProfileInfoCollection
Public Shared Function GetAllProfiles (authenticationOption As ProfileAuthenticationOption) As ProfileInfoCollection
Parameter
- authenticationOption
- ProfileAuthenticationOption
Einer der ProfileAuthenticationOption-Enumerationswerte, der angibt, ob anonyme, authentifizierte oder beide Profiltypen zurückgegeben werden.
Gibt zurück
Eine ProfileInfoCollection, die Benutzerprofilinformationen für alle Profile in der Datenquelle enthält.
Beispiele
Im folgenden Codebeispiel werden Profilinformationen für alle Profile für das konfigurierte applicationName
angezeigt.
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Profile" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
public void Page_Load()
{
TotalLabel.Text = ProfileManager.GetNumberOfProfiles(ProfileAuthenticationOption.All).ToString();
GetProfiles();
}
private void GetProfiles()
{
ProfileGrid.DataSource = ProfileManager.GetAllProfiles(ProfileAuthenticationOption.All);
ProfileGrid.DataBind();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Find Profiles</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Profile List</h3>
<asp:Label id="TotalLabel" runat="server" text="0" /> Profiles found.<br />
<asp:GridView id="ProfileGrid" runat="server"
CellPadding="2" CellSpacing="1" Gridlines="Both">
<HeaderStyle BackColor="darkblue" ForeColor="white" />
</asp:GridView>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Profile" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Public Sub Page_Load()
TotalLabel.Text = ProfileManager.GetNumberOfProfiles(ProfileAuthenticationOption.All).ToString()
GetProfiles()
End Sub
Private Sub GetProfiles()
ProfileGrid.DataSource = ProfileManager.GetAllProfiles(ProfileAuthenticationOption.All)
ProfileGrid.DataBind()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Find Profiles</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Profile List</h3>
<asp:Label id="TotalLabel" runat="server" text="0" /> Profiles found.<br />
<asp:GridView id="ProfileGrid" runat="server"
CellPadding="2" CellSpacing="1" Gridlines="Both">
<HeaderStyle BackColor="darkblue" ForeColor="white" />
</asp:GridView>
</form>
</body>
</html>
Hinweise
Die GetAllProfiles -Methode wird verwendet, um Profilinformationen aus der Datenquelle für die Anwendung abzurufen, die durch das applicationName
Attribut in der Konfigurationsdatei angegeben wird. Verwenden Sie den authenticationOption
Parameter, um anzugeben, ob nur anonyme Profile, nur authentifizierte Profile oder alle Profile durchsucht werden sollen.
Sie können Seiten von ProfileInfo Objekten für Benutzerprofile mithilfe der Überladung für die Methode abrufen, die GetAllProfiles zusätzliche pageIndex
Parameter und pageSize
benötigt.
Die GetAllProfiles -Methode ruft die GetAllProfiles Methode des Standardprofilanbieters auf. Der Standardprofilanbieter wird mithilfe des defaultProvider
Attributs des Profilkonfigurationselements angegeben. Wenn das Benutzerprofil Eigenschaften enthält, die von einem anderen Profilanbieter als dem Standardanbieter verwaltet werden, wird die Datenquelle für den anderen Profilanbieter nicht durchsucht. Um Profile zu finden, die von einem anderen Profilanbieter als dem Standardanbieter verwaltet werden, rufen Sie mithilfe Providers der -Eigenschaft einen Verweis auf den Profilanbieter ab, und rufen Sie die GetAllProfiles Methode des Anbieters direkt auf.
Weitere Informationen
Gilt für:
GetAllProfiles(ProfileAuthenticationOption, Int32, Int32, Int32)
Ruft Seiten von Benutzerprofildaten ab.
public:
static System::Web::Profile::ProfileInfoCollection ^ GetAllProfiles(System::Web::Profile::ProfileAuthenticationOption authenticationOption, int pageIndex, int pageSize, [Runtime::InteropServices::Out] int % totalRecords);
public static System.Web.Profile.ProfileInfoCollection GetAllProfiles (System.Web.Profile.ProfileAuthenticationOption authenticationOption, int pageIndex, int pageSize, out int totalRecords);
static member GetAllProfiles : System.Web.Profile.ProfileAuthenticationOption * int * int * int -> System.Web.Profile.ProfileInfoCollection
Public Shared Function GetAllProfiles (authenticationOption As ProfileAuthenticationOption, pageIndex As Integer, pageSize As Integer, ByRef totalRecords As Integer) As ProfileInfoCollection
Parameter
- authenticationOption
- ProfileAuthenticationOption
Einer der ProfileAuthenticationOption-Enumerationswerte, der angibt, ob anonyme, authentifizierte oder beide Profiltypen zurückgegeben werden.
- pageIndex
- Int32
Der Index der zurückgegebenen Ergebnisseite.
pageIndex
ist nullbasiert.
- pageSize
- Int32
Die Größe der zurückzugebenden Ergebnisseite.
- totalRecords
- Int32
Diese Methode enthält bei der Rückgabe eine ganze Zahl, die die Gesamtanzahl von Profilen bezeichnet. Dieser Parameter wird nicht initialisiert übergeben.
Gibt zurück
Eine ProfileInfoCollection, die Benutzerprofilinformationen für alle Profile in der Datenquelle enthält.
Beispiele
Im folgenden Codebeispiel werden Profilinformationen für alle Profile für die in Datenseiten konfigurierten applicationName
Profile angezeigt.
<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Profile" %>
<!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 totalProfiles;
int totalPages;
int currentPage = 1;
public void Page_Load()
{
if (!IsPostBack)
{
GetProfiles();
}
}
private void GetProfiles()
{
ProfileGrid.DataSource = ProfileManager.GetAllProfiles(
ProfileAuthenticationOption.All,
currentPage - 1, pageSize, out totalProfiles);
totalPages = ((totalProfiles - 1) / pageSize) + 1;
// Ensure that we do not navigate past the last page of Profiles.
if (currentPage > totalPages)
{
currentPage = totalPages;
GetProfiles();
return;
}
ProfileGrid.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 (totalProfiles <= 0)
NavigationPanel.Visible = false;
else
NavigationPanel.Visible = true;
}
public void NextButton_OnClick(object sender, EventArgs args)
{
currentPage = Convert.ToInt32(CurrentPageLabel.Text);
currentPage++;
GetProfiles();
}
public void PreviousButton_OnClick(object sender, EventArgs args)
{
currentPage = Convert.ToInt32(CurrentPageLabel.Text);
currentPage--;
GetProfiles();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Find Profiles</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Profile List</h3>
<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:GridView id="ProfileGrid" runat="server"
CellPadding="2" CellSpacing="1" Gridlines="Both">
<HeaderStyle BackColor="darkblue" ForeColor="white" />
</asp:GridView>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<%@ Import Namespace="System.Web.Profile" %>
<!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 totalProfiles As Integer
Dim totalPages As Integer
Dim currentPage As Integer = 1
Public Sub Page_Load()
If Not IsPostBack Then
GetProfiles()
End If
End Sub
Private Sub GetProfiles()
ProfileGrid.DataSource = ProfileManager.GetAllProfiles( _
ProfileAuthenticationOption.All, _
currentPage - 1, pageSize, totalProfiles)
totalPages = ((totalProfiles - 1) \ pageSize) + 1
' Ensure that we do not navigate past the last page of Profiles.
If currentPage > totalPages Then
currentPage = totalPages
GetProfiles()
Return
End If
ProfileGrid.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 totalProfiles <= 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
GetProfiles()
End SUb
Public Sub PreviousButton_OnClick(sender As Object, args As EventArgs)
currentPage = Convert.ToInt32(CurrentPageLabel.Text)
currentPage -= 1
GetProfiles()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Find Profiles</title>
</head>
<body>
<form id="form1" runat="server">
<h3>Profile List</h3>
<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:GridView id="ProfileGrid" runat="server"
CellPadding="2" CellSpacing="1" Gridlines="Both">
<HeaderStyle BackColor="darkblue" ForeColor="white" />
</asp:GridView>
</form>
</body>
</html>
Hinweise
Die GetAllProfiles -Methode wird verwendet, um Profilinformationen aus der Datenquelle für die Anwendung abzurufen, die durch das applicationName
Attribut in der Konfigurationsdatei angegeben wird. Verwenden Sie den authenticationOption
Parameter, um anzugeben, ob nur anonyme Profile, nur authentifizierte Profile oder alle Profile durchsucht werden sollen.
Die von GetAllInactiveProfiles zurückgegebenen Ergebnisse werden durch die pageIndex
Parameter und pageSize
eingeschränkt. Der pageSize
-Parameter gibt die maximale Anzahl von ProfileInfo Objekten an, die ProfileInfoCollectionin zurückgegeben werden sollen. Der pageIndex
Parameter gibt an, welche Ergebnisseite zurückgegeben werden soll. Null identifiziert die erste Seite. Der totalRecords
Parameter ist ein out
Parameter, der auf die Gesamtanzahl inaktiver Benutzerprofile für das konfigurierte applicationName
festgelegt ist, basierend auf dem angegebenen authenticationOption
. Wenn es beispielsweise 13 Benutzer für die konfigurierte applicationName
gibt und der pageIndex
Wert eins mit einem pageSize
von 5 ist, enthält das ProfileInfoCollection zurückgegebene das sechste bis zehnte Profil. Der totalRecords
Parameter wird auf 13 festgelegt.
Die GetAllProfiles -Methode ruft die GetAllProfiles Methode des Standardprofilanbieters auf. Der Standardprofilanbieter wird mithilfe des defaultProvider
Attributs des Profilkonfigurationselements angegeben. Wenn das Benutzerprofil Eigenschaften enthält, die von einem anderen Profilanbieter als dem Standardanbieter verwaltet werden, wird die Datenquelle für den anderen Profilanbieter nicht durchsucht. Um Profile zu finden, die von einem anderen Profilanbieter als dem Standardanbieter verwaltet werden, rufen Sie mithilfe Providers der -Eigenschaft einen Verweis auf den Profilanbieter ab, und rufen Sie die GetAllProfiles Methode des Anbieters direkt auf.