Bagikan melalui

AuthorizationStoreRoleProvider.DeleteRole(String, Boolean) Metode

Definisi

Ruang nama:
System.Web.Security
Rakitan:
System.Web.dll

Menghapus peran dari penyimpanan kebijakan manajer otorisasi.

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

Nama peran yang akan dihapus.

throwOnPopulatedRole
Boolean

Jika true, melemparkan pengecualian jika roleName memiliki satu atau beberapa anggota.

Mengembalikan

Boolean

true jika peran dihapus; jika tidak, false.

Pengecualian

ArgumentNullException

roleNameadalah null.

ArgumentException

roleName adalah string kosong.

-atau-

roleName berisi koma.

ProviderException

roleName memiliki satu atau beberapa anggota dan throwOnPopulatedRole adalah true.

-atau-

applicationName Konfigurasi tidak ditemukan.

-atau-

scopeName Konfigurasi tidak ditemukan.

-atau-

Runtime manajer otorisasi tidak diinstal pada server.

FileNotFoundException

Atribut connectionStringName mereferensikan string koneksi ke file yang tidak ada.

HttpException

AuthorizationStoreRoleProvider Instans dikonfigurasi dengan penyimpanan kebijakan berbasis file, dan akses baca ke file tidak diizinkan pada tingkat kepercayaan saat ini.

Contoh

Contoh berikut menghapus peran dari penyimpanan kebijakan manajer otorisasi. Untuk contoh file Web.config yang memungkinkan manajemen peran, lihat 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>

Keterangan

Metode DeleteRole ini dipanggil oleh Roles kelas untuk menghapus peran dari penyimpanan kebijakan manajer otorisasi yang ditentukan dalam file konfigurasi aplikasi ASP.NET (Web.config). Saat peran dihapus, daftar pengguna yang terkait dengan peran tersebut juga dihapus dari penyimpanan kebijakan. Informasi pengguna dalam database tidak terpengaruh.

Jika throwOnPopulatedRole adalah true, maka pengecualian akan dilemparkan dan peran tidak akan dihapus jika peran yang diidentifikasi oleh roleName parameter memiliki satu atau beberapa anggota. Jika throwOnPopulatedRole adalah false, maka peran akan dihapus apakah kosong atau tidak.

Berlaku untuk

Lihat juga