AuthorizationStoreRoleProvider.DeleteRole(String, Boolean) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Security

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Usuwa rolę z magazynu zasad menedżera autoryzacji.

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

Parametry

roleName: String

Nazwa roli do usunięcia.

throwOnPopulatedRole: Boolean

Jeśli trueparametr zgłasza wyjątek, jeśli roleName ma co najmniej jednego członka.

Zwraca

Boolean

true jeśli rola została usunięta; w przeciwnym razie , false.

Wyjątki

ArgumentNullException

roleName to null.

ArgumentException

roleName jest pustym ciągiem.

-lub- roleName zawiera przecinek.

ProviderException

roleName ma co najmniej jednego członka i throwOnPopulatedRole ma wartość true.

-lub- Nie można odnaleźć skonfigurowanego applicationName .

-lub- Nie można odnaleźć skonfigurowanego scopeName .

-lub- Środowisko uruchomieniowe menedżera autoryzacji nie jest zainstalowane na serwerze.

FileNotFoundException

Atrybut connectionStringName odwołuje się do parametrów połączenia z plikiem, który nie istnieje.

HttpException

Wystąpienie AuthorizationStoreRoleProvider jest skonfigurowane z magazynem zasad opartym na plikach, a dostęp do odczytu do pliku jest niedozwolony na bieżącym poziomie zaufania.

Przykłady

Poniższy przykład usuwa rolę z magazynu zasad menedżera autoryzacji. Aby zapoznać się z przykładem pliku Web.config umożliwiającego zarządzanie rolami, zobacz 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>

Uwagi

Metoda DeleteRole jest wywoływana przez Roles klasę w celu usunięcia roli z magazynu zasad menedżera autoryzacji określonego w pliku konfiguracji aplikacji ASP.NET (Web.config). Po usunięciu roli lista użytkowników skojarzonych z tą rolą jest również usuwana z magazynu zasad. Nie ma to wpływu na informacje o użytkowniku w bazie danych.

Jeśli throwOnPopulatedRole parametr ma truewartość , zostanie zgłoszony wyjątek, a rola nie zostanie usunięta, jeśli rola zidentyfikowana przez roleName parametr ma co najmniej jeden element członkowny. Jeśli throwOnPopulatedRole ma falsewartość , rola zostanie usunięta bez względu na to, czy jest pusta, czy nie.

Dotyczy

Zobacz też

Opis zarządzania rolami ASP.NET

Share via