AuthorizationStoreRoleProvider.DeleteRole(String, Boolean) Methode

Definition

Namespace:
System.Web.Security
Assembly:
System.Web.dll

Entfernt eine Rolle aus dem Autorisierungs-Manager-Richtlinienspeicher.

public:
 override bool DeleteRole(System::String ^ roleName, bool throwOnPopulatedRole);
public override bool DeleteRole(string roleName, bool throwOnPopulatedRole);
override this.DeleteRole : string * bool -> bool
Public Overrides Function DeleteRole (roleName As String, throwOnPopulatedRole As Boolean) As Boolean

Parameter

roleName
String

Der Name der zu löschenden Rolle.

throwOnPopulatedRole
Boolean

Wenn true, löst eine Ausnahme aus, wenn roleName mindestens ein Element vorhanden ist.

Gibt zurück

Boolean

truewenn die Rolle gelöscht wurde; andernfalls . false

Ausnahmen

ArgumentNullException

roleName ist null.

ArgumentException

roleName ist eine leere Zeichenfolge.

-oder-

roleName enthält ein Komma.

ProviderException

roleName hat mindestens ein Element und throwOnPopulatedRole ist true.

-oder-

Die Konfiguration applicationName wurde nicht gefunden.

-oder-

Die Konfiguration scopeName wurde nicht gefunden.

-oder-

Die Autorisierungs-Manager-Laufzeit ist nicht auf dem Server installiert.

FileNotFoundException

Das connectionStringName Attribut verweist auf eine Verbindungszeichenfolge auf eine Datei, die nicht vorhanden ist.

HttpException

Die AuthorizationStoreRoleProvider Instanz ist mit einem dateibasierten Richtlinienspeicher konfiguriert, und der Lesezugriff auf die Datei ist auf der aktuellen Vertrauensebene nicht zulässig.

Beispiele

Im folgenden Beispiel wird eine Rolle aus dem Autorisierungs-Manager-Richtlinienspeicher gelöscht. Ein Beispiel für eine Web.config Datei, die die Rollenverwaltung ermöglicht, finden Sie unter AuthorizationStoreRoleProvider.


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


<%@ 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 rolesArray() As String

  Public Sub Page_Load(ByVal sender As Object, ByVal args As EventArgs)

    If Not IsPostBack Then
      ' Bind roles to ListBox.

      rolesArray = Roles.GetAllRoles()
      RolesListBox.DataSource = rolesArray
      RolesListBox.DataBind()
    End If

  End Sub


  Public Sub DeleteRole_OnClick(ByVal sender As Object, ByVal args As EventArgs)

    Dim delRole As String

    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."
    End Try

  End Sub

</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>

Hinweise

Die methode DeleteRole wird von der klasse Roles aufgerufen, um eine Rolle aus dem Autorisierungs-Manager-Richtlinienspeicher zu löschen, der in der Konfigurationsdatei der ASP.NET Anwendung angegeben ist (Web.config). Wenn eine Rolle gelöscht wird, wird auch die Liste der Benutzer, die dieser Rolle zugeordnet sind, aus dem Richtlinienspeicher gelöscht. Die Benutzerinformationen in der Datenbank sind nicht betroffen.

Wenn throwOnPopulatedRole ja true, wird eine Ausnahme ausgelöst, und die Rolle wird nicht gelöscht, wenn die durch den roleName Parameter identifizierte Rolle mindestens ein Element enthält. Wenn throwOnPopulatedRole ja false, wird die Rolle gelöscht, unabhängig davon, ob sie leer ist oder nicht.

Gilt für:

Weitere Informationen