Esta documentación está archivada y no tiene mantenimiento.

Roles.RemoveUsersFromRole (Método)

Quita los usuarios especificados de la función especificada.

Espacio de nombres: System.Web.Security
Ensamblado: System.Web (en system.web.dll)

public static void RemoveUsersFromRole (
	string[] usernames,
	string roleName
)
public static void RemoveUsersFromRole (
	String[] usernames, 
	String roleName
)
public static function RemoveUsersFromRole (
	usernames : String[], 
	roleName : String
)
No aplicable.

Parámetros

usernames

Una matriz de cadena de nombres de usuario que se quitarán de las funciones especificadas.

roleName

El nombre de la función de la que se quitan los usuarios especificados.

Tipo de excepciónCondición

System.ArgumentNullException

El valor de roleName es referencia null (Nothing en Visual Basic).

O bien

Uno de los nombres de usuario de usernames es referencia null (Nothing en Visual Basic).

System.ArgumentException

roleName es una cadena vacía o contiene una coma (,).

O bien

Uno de los nombres de usuario de usernames es una cadena vacía o contiene una coma (,).

O bien

usernames contiene un elemento duplicado.

System.Configuration.Provider.ProviderException

No está habilitada la administración de funciones.

El método RemoveUsersFromRole llama al proveedor de funciones predeterminado para quitar los usuarios especificados de la función especificada en el origen de datos.

Si la aplicación utiliza la clase SqlRoleProvider, las actualizaciones de base de datos realizadas durante la llamada al método RemoveUsersFromRoles se llevan a cabo dentro de una transacción. Si se encuentra un error, como un nombre de usuario que no está incluido en una función especificada, la transacción se deshace y no se realizan actualizaciones.

En el ejemplo de código siguiente se utiliza el método RemoveUsersFromRole para quitar uno o varios usuarios de una función. Para obtener un ejemplo de un archivo Web.config que habilita la administración de funciones, vea 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;
string[] users;

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

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

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

public void RolesListBox_OnSelectedIndexChanged(object sender, EventArgs args)
{
  // Bind users to ListBox.

  users = Roles.GetUsersInRole(RolesListBox.SelectedItem.Value);
  UsersListBox.DataSource = users;
  UsersListBox.DataBind();
}

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

  int[] user_indices = UsersListBox.GetSelectedIndices();

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

  if (RolesListBox.SelectedItem == null)
  {
    Msg.Text = "Please select a role.";
    return;
  }


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

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

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


  // Remove the users from the selected role.

  try
  {
    Roles.RemoveUsersFromRole(usersList, RolesListBox.SelectedItem.Value);  
    Msg.Text = "User(s) removed from Role.";

    // Rebind users to ListBox.

    users = Roles.GetUsersInRole(RolesListBox.SelectedItem.Value);
    UsersListBox.DataSource = users;
    UsersListBox.DataBind();
  }
  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" AutoPostBack="true" 
                                    OnSelectedIndexChanged="RolesListBox_OnSelectedIndexChanged" 
                                    runat="server" Rows="8" /></td>
      <td valign="top">Users:</td>
      <td valign="top"><asp:ListBox id="UsersListBox" Rows="8" 
                                    SelectionMode="Multiple" runat="server" /></td>
      <td valign="top"><asp:Button Text="Remove User(s) from Role" id="RemoveUsersButton"
                                   runat="server" OnClick="RemoveUsers_OnClick" /></td>
    </tr>
  </table>
</form>

</body>
</html>

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: