Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Roles.DeleteRole (String, Boolean)

 

Data di pubblicazione: ottobre 2016

Rimuove un ruolo dall'origine dati.

Spazio dei nomi:   System.Web.Security
Assembly:  System.Web (in System.Web.dll)

public static bool DeleteRole(
	string roleName,
	bool throwOnPopulatedRole
)

Parametri

roleName
Type: System.String

Nome del ruolo da eliminare.

throwOnPopulatedRole
Type: System.Boolean

Se true, viene generata un'eccezione se roleName ha uno o più membri.

Valore restituito

Type: System.Boolean

true Se roleName è stato eliminato dall'origine dati; in caso contrario, false.

Exception Condition
System.ArgumentNullException

roleName è null.

System.ArgumentException

Il parametro roleName è una stringa vuota.

System.Configuration.Provider.ProviderException

roleName dispone di uno o più membri e throwOnPopulatedRole è true.

-oppure-

Gestione dei ruoli non è abilitata.

Il DeleteRole metodo rimuove un nome di ruolo dall'origine dati. DeleteRole chiamate di DeleteRole metodo del provider di ruoli predefinito per rimuovere il ruolo specificato dall'origine dati.

Se throwOnPopulatedRole è true, verrà generata un'eccezione e il ruolo non verrà eliminato se il ruolo identificato dal roleName parametro ha uno o più membri. Se throwOnPopulatedRole è false, se è vuota o non viene eliminato il ruolo.

Esempio di codice seguente elimina un ruolo dall'origine dati. Per un esempio di un file Web. config che consente la gestione dei ruoli, vedere Roles.


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

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: