Exportar (0) Imprimir
Expandir todo

SqlRoleProvider.DeleteRole (Método)

Quita una función de la base de datos de funciones.

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

public override bool DeleteRole (
	string roleName,
	bool throwOnPopulatedRole
)
public boolean DeleteRole (
	String roleName, 
	boolean throwOnPopulatedRole
)
public override function DeleteRole (
	roleName : String, 
	throwOnPopulatedRole : boolean
) : boolean
No aplicable.

Parámetros

roleName

Nombre de la función que se va a eliminar.

throwOnPopulatedRole

Si es true, se produce una excepción si roleName tiene uno o más miembros.

Valor devuelto

true si la función se ha eliminado correctamente; en caso contrario, false.

Tipo de excepciónCondición

System.ArgumentNullException

roleName es referencia null (Nothing en Visual Basic) ( Nothingen Visual Basic).

System.ArgumentException

roleName es una cadena vacía o contiene una coma.

O bien

roleName tiene más de 256 caracteres.

System.Configuration.Provider.ProviderException

roleName tiene uno o más miembros y throwOnPopulatedRole es true.

O bien

Se ha producido un error desconocido al establecer comunicación con la base de datos.

La clase Roles llama al método DeleteRole para eliminar una función de la base de datos de SQL Server especificada en el archivo de configuración de la aplicación ASP.NET (Web.config). Cuando se elimina una función, la lista de usuarios asociada a esa función también se elimina de la base de datos. La información de usuario que contiene la base de datos no se ve afectada.

Si throwOnPopulatedRole es true, se producirá una excepción y la función no se eliminará si la función identificada por el parámetro roleName tiene uno o más miembros. Si throwOnPopulatedRole es false, la función se eliminará tanto si está vacía como si no.

En el ejemplo siguiente se elimina una función de la base de datos. Para obtener un ejemplo de un archivo Web.config que habilita la administración de funciones, vea SqlRoleProvider.


<%@ 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[] rolesArray;

  public void Page_Load(object sender, EventArgs args)
  {
    if (!IsPostBack)
    {
      // Bind roles to ListBox.

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


  public void DeleteRole_OnClick(object sender, EventArgs args)
  {
    string delRole = "";

    try
    {
      delRole = RolesListBox.SelectedItem.Value;

      Roles.DeleteRole(delRole);

      Msg.Text = "Role '" + Server.HtmlEncode(delRole) + "' deleted.";


      // Re-bind roles to ListBox.

      rolesArray = Roles.GetAllRoles();
      RolesListBox.DataSource = rolesArray;
      RolesListBox.DataBind();
    }
    catch
    {
      Msg.Text = "Role '" + Server.HtmlEncode(delRole) + "' <u>not</u> deleted.";
    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
  <title>Sample: Delete Role</title>
</head>
<body>
  <form runat="server" id="PageForm">
    <h3>
      Delete Role</h3>
    <asp:Label ID="Msg" ForeColor="maroon" runat="server" /><br />
    <table border="0">
      <tr>
        <td valign="top">
          Delete Role:</td>
        <td valign="top">
          <asp:ListBox ID="RolesListBox" runat="server" Rows="8" /></td>
        <td valign="top">
          <asp:Button Text="Delete Role" ID="DeleteRoleButton" runat="server" OnClick="DeleteRole_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

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft