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.

Roles.RemoveUsersFromRoles أسلوب

Visual Studio 2010

قم بإزالة أسماء معينة من الأدوار المحددة.

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

public static void RemoveUsersFromRoles(
	string[] usernames,
	string[] roleNames
)

المعلمات

usernames
النوع: System.String[]
صفيف سلسلة من أسماء المستخدمين إلى إزالة من الأدوار المحددة.
roleNames
النوع: System.String[]
صفيفة سلسلة أسماء دور إلى إزالة المستخدمين المحددين من.

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

واحد الأدوار المحددة في roleNamesهو null.

-أو-

واحد المستخدمين المحددة في usernamesهو null.

System.ArgumentException

واحد الأدوار المحددة في roleNamesهو سلسلة فارغ أو تحتوي على فاصلة (،).

-أو-

واحد المستخدمين المحددة في usernamesهو سلسلة فارغ أو تحتوي على فاصلة (،).

-أو-

roleNames يحتوي على a duplicate عنصر.

-أو-

usernames يحتوي على a duplicate عنصر.

System.Configuration.Provider.ProviderException

دور management ليس ممكّن.

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

إذا كان تطبيق يستخدم SqlRoleProviderالفئة تحديثات قاعدة بيانات التي يتم إجراؤها أثناء الاستدعاء إلى RemoveUsersFromRolesالطريقة التي يتم إجراؤها داخل عملية. في حالة حدوث خطأ هو مصادفة، مثل اسم مستخدم الذي هو ليس في دور معين، وعملية هو التراجع وليس التحديثات التي يتم تنفيذها.

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


<%@ Page Language="C#" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Web.UI" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

string[] rolesArray;
MembershipUserCollection users;

public void Page_Load()
{
  Msg.Text = "";

  if (!IsPostBack)
  {
    // Bind roles to ListBox.

    rolesArray = Roles.GetAllRoles();
    RolesListBox.DataSource = rolesArray;
    RolesListBox.DataBind();

    // Bind users to ListBox.

    users = Membership.GetAllUsers();
    UsersListBox.DataSource = users;
    UsersListBox.DataBind();
  }
}


public void RemoveUsers_OnClick(object sender, EventArgs args)
{
  // Verify that at least one user and one role are selected.

  int[] user_indices = UsersListBox.GetSelectedIndices();

  if (user_indices.Length == 0)
  {
    Msg.Text = "Please select one or more users.";
    return;
  }

  int[] role_indices = RolesListBox.GetSelectedIndices();

  if (role_indices.Length == 0)
  {
    Msg.Text = "Please select one or more roles.";
    return;
  }


  // Create list of users to be removed from the selected roles.

  string[] usersList = new string[user_indices.Length];

  for (int i = 0; i < usersList.Length; i++)
  {
    usersList[i] = UsersListBox.Items[user_indices[i]].Value;
  }


  // Create list of roles to be remove the selected users from.

  string[] rolesList = new string[role_indices.Length];

  for (int i = 0; i < rolesList.Length; i++)
  {
    rolesList[i] = RolesListBox.Items[role_indices[i]].Value;
  }


  // Remove the users from the selected roles.

  try
  {
    Roles.RemoveUsersFromRoles(usersList, rolesList);  
    Msg.Text = "User(s) removed from Role(s).";
  }
  catch (HttpException e)
  {
    Msg.Text = e.Message;
  } 
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>Sample: Role Membership</title>
</head>
<body>

<form runat="server" id="PageForm">
  <h3>Role Membership</h3>
  <asp:Label id="Msg" ForeColor="maroon" runat="server" /><br />
  <table cellpadding="3" border="0">
    <tr>
      <td valign="top">Roles:</td>
      <td valign="top"><asp:ListBox id="RolesListBox" runat="server" SelectionMode="Multiple"
                                    Rows="8" /></td>
      <td valign="top">Users:</td>
      <td valign="top"><asp:ListBox id="UsersListBox" DataTextField="Username" 
                                  Rows="8" SelectionMode="Multiple" runat="server" /></td>
      <td valign="top"><asp:Button Text="Remove User(s) from Role(s)" id="RemoveUsersButton"
                                 runat="server" OnClick="RemoveUsers_OnClick" /></td>
    </tr>
  </table>
</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
إظهار: