This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

SqlRoleProvider.FindUsersInRole أسلوب

Visual Studio 2010

يحصل على صفيفة أسماء مستخدمين بالموقع يحتوي على اسم مستخدم اسم مستخدم المحدد إلى دور مطابقة.

مساحة الاسم:  System.Web.Security
التجميع:  System.Web (في System.Web.dll)

public override string[] FindUsersInRole(
	string roleName,
	string usernameToMatch
)

المعلمات

roleName
النوع: System.String
دور البحث فيها.
usernameToMatch
النوع: System.String
اسم مستخدم إلى البحث عنها.

القيمة المُرجعة

النوع: System.String[]
صفيفة سلسلة التي تحتوي على أسماء مستخدمين الموقع يطابق اسم مستخدم usernameToMatchومستخدم هو عضوا دور معين.

استثناء:شرط
System.ArgumentNullException

roleNameهوnull(Nothingفي Visual أساسى).

-أو-

usernameToMatch هو null.

System.ArgumentException

roleNameهو سلسلة فارغ أو تحتوي على فاصلة.

-أو-

usernameToMatchهو على سلسلة فارغ.

-أو-

roleNameهو أطول من 256 حرفاً.

-أو-

usernameToMatchهو أطول من 256 حرفاً.

System.Configuration.Provider.ProviderException

roleNameغير موجود في قاعدة بيانات.

-أو-

حدث خطأ غير معروف أثناء الاتصال مع قاعدة البيانات.

FindUsersInRole أسلوب هو استدعاؤها بواسطة Rolesللفئات وإرجاع lهوt مستخدمين في دور الموقع يحتوي اسم مستخدم على مطابقة للذي تم توفيره usernameToMatchللمكون applicationName. SqlRoleProvider بالبحث عن اسم مستخدم الذي يتطابق مع usernameToMatchقيمة المعلمة مثل استخدام الكلمة الأساسية واعتماد SQL الخادم أحرف البدل. على سبيل المثال، إذا كان usernameToMatchتعيين معلمة إلى "user1"، ثم عضوية يتم إرجاع معلومات من أجل مستخدم بواسطة اسم مستخدم "user1"، أن وجد. إذا usernameToMatchتعيين معلمة إلى "% المستخدم"، ثم عضوية يتم إرجاع معلومات للمستخدمين باستخدام اسم المستخدم "user1" و "user2"، "user_admin" وهكذا.

يلي تعليمات برمجية يستخدم المثال FindUsersInRoleالأسلوب لعرض عضوية دور استناداً إلى إدخال مستخدم. على سبيل مثال ملف ويب.config تمكن دور الإدارة، راجع Roles.

ملاحظة الأمانملاحظة الأمان

يحتوي هذا المثال على مربع النص الذي يقبل إدخال المستخدم مما يعد تهديد أمان محتمل. بشكل افتراضي، تتحقق صفحات ويب ASP.NET من أن مُدخلات المستخدم لا تتضمن برنامج نصي أو عناصر HTML. لمزيد من المعلومات، راجع نظرة عامة حول عمليات استغلال البرنامج النصي.


<%@ 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>


نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: