SqlRoleProvider.FindUsersInRole(String, String) 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 ein Array von Benutzernamen in einer Rolle ab, in der der Benutzername den angegebenen Benutzernamen enthält, der übereinstimmen soll.
public:
override cli::array <System::String ^> ^ FindUsersInRole(System::String ^ roleName, System::String ^ usernameToMatch);public override string[] FindUsersInRole(string roleName, string usernameToMatch);override this.FindUsersInRole : string * string -> string[]Public Overrides Function FindUsersInRole (roleName As String, usernameToMatch As String) As String()Parameter
- roleName
- String
Die Rolle, in der gesucht werden soll.
- usernameToMatch
- String
Der Benutzername, nach dem gesucht werden soll.
Gibt zurück
Ein Zeichenfolgenarray, das die Namen aller Benutzer enthält, in denen der Benutzername übereinstimmt usernameToMatch und der Benutzer Mitglied der angegebenen Rolle ist.
Ausnahmen
roleName ist eine leere Zeichenfolge oder enthält ein Komma.
-oder-
usernameToMatch ist eine leere Zeichenfolge.
-oder-
roleName ist länger als 256 Zeichen.
-oder-
usernameToMatch ist länger als 256 Zeichen.
roleName wurde in der Datenbank nicht gefunden.
-oder-
Unbekannter Fehler beim Kommunizieren mit der Datenbank.
Beispiele
Im folgenden Codebeispiel wird die FindUsersInRole Methode verwendet, um die Rollenmitgliedschaft basierend auf benutzereingaben anzuzeigen. Ein Beispiel für eine Web.config Datei, die die Rollenverwaltung ermöglicht, finden Sie unter Roles.
Important
Dieses Beispiel enthält ein Textfeld, das Benutzereingaben akzeptiert, bei denen es sich um eine potenzielle Sicherheitsrisiken handelt. Standardmäßig überprüfen ASP.NET Webseiten, dass die Benutzereingabe keine Skript- oder HTML-Elemente enthält. Weitere Informationen finden Sie unter Script Exploits Overview.
<%@ 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">
string[] users;
public void Page_Load()
{
if (!IsPostBack)
{
RolesListBox.DataSource = Roles.GetAllRoles();
RolesListBox.DataBind();
}
}
public void GoButton_OnClick(object sender, EventArgs args)
{
Msg.Text = "";
users = null;
if (RolesListBox.SelectedItem == null)
{
Msg.Text = "Please select a role.";
return;
}
users = Roles.FindUsersInRole(RolesListBox.SelectedItem.Text, UsernameTextBox.Text);
if (users.Length < 1)
{
Msg.Text = "No matching users found in selected role.";
}
UserGrid.DataSource = users;
UserGrid.DataBind();
}
</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>
<asp:Label id="Msg" runat="Server" ForeColor="red" />
<table border="0" cellpadding="3" cellspacing="3">
<tr>
<td valign="top">Role:</td>
<td valign="top"><asp:ListBox id="RolesListBox" runat="Server" /></td>
</tr>
<tr>
<td valign="top">Username to Search for:</td>
<td valign="top"><asp:TextBox id="UsernameTextBox" runat="server" /></td>
</tr>
</table>
<asp:Button id="GoButton" Text=" Go " OnClick="GoButton_OnClick" runat="server" /><br />
<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 users() As String
Public Sub Page_Load()
If Not IsPostBack Then
RolesListBox.DataSource = Roles.GetAllRoles()
RolesListBox.DataBind()
End If
End SUb
Public Sub GoButton_OnClick(sender As Object, args As EventArgs)
Msg.Text = ""
users = Nothing
If RolesListBox.SelectedItem Is Nothing Then
Msg.Text = "Please select a role."
Return
End If
users = Roles.FindUsersInRole(RolesListBox.SelectedItem.Text, UsernameTextBox.Text)
If users.Length < 1 Then
Msg.Text = "No matching users found in selected role."
End If
UserGrid.DataSource = users
UserGrid.DataBind()
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>
<asp:Label id="Msg" runat="Server" ForeColor="red" />
<table border="0" cellpadding="3" cellspacing="3">
<tr>
<td valign="top">Role:</td>
<td valign="top"><asp:ListBox id="RolesListBox" runat="Server" /></td>
</tr>
<tr>
<td valign="top">Username to Search for:</td>
<td valign="top"><asp:TextBox id="UsernameTextBox" runat="server" /></td>
</tr>
</table>
<asp:Button id="GoButton" Text=" Go " OnClick="GoButton_OnClick" runat="server" /><br />
<asp:DataGrid id="UserGrid" runat="server"
CellPadding="2" CellSpacing="1"
Gridlines="Both">
<HeaderStyle BackColor="darkblue" ForeColor="white" />
</asp:DataGrid>
</form>
</body>
</html>
Hinweise
Die FindUsersInRole Methode wird von der Roles Klasse aufgerufen und gibt eine Liste der Benutzer in einer Rolle zurück, in der der Benutzername eine Übereinstimmung der für die konfigurierten Elemente applicationNameenthältusernameToMatch. Der SqlRoleProvider sucht nach einem Benutzernamen, der dem Parameterwert usernameToMatch entspricht, und unterstützt SQL Server Wildcardzeichen. Wenn der usernameToMatch Parameter beispielsweise auf "user1" festgelegt ist, werden mitgliedschaftsinformationen für den Benutzer mit dem Benutzernamen "user1" zurückgegeben, sofern er vorhanden ist. Wenn der usernameToMatch Parameter auf "Benutzer%" festgelegt ist, werden Mitgliedschaftsinformationen für Benutzer mit dem Benutzernamen "user1", "user2", "user_admin" usw. zurückgegeben.