WindowsTokenRoleProvider Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene le informazioni sui ruoli per un'applicazione ASP.NET dall'appartenenza a gruppi Windows.
public ref class WindowsTokenRoleProvider : System::Web::Security::RoleProvider
public class WindowsTokenRoleProvider : System.Web.Security.RoleProvider
type WindowsTokenRoleProvider = class
inherit RoleProvider
Public Class WindowsTokenRoleProvider
Inherits RoleProvider
- Ereditarietà
Esempio
Nell'esempio seguente viene illustrato il file di Web.config per un'applicazione ASP.NET. Specifica che l'applicazione usa sia autenticazione di Windows che la classe WindowsTokenRoleProvider per recuperare le informazioni sul ruolo per gli utenti di Windows. L'elemento authorization specifica che solo gli utenti del gruppo BUILTIN\Administrators sono autorizzati ad accedere all'applicazione.
<configuration>
<system.web>
<authentication mode="Windows" />
<authorization>
<allow roles="BUILTIN\Administrators" />
<deny users="*" />
</authorization>
<roleManager defaultProvider="WindowsProvider"
enabled="true"
cacheRolesInCookie="false">
<providers>
<add
name="WindowsProvider"
type="System.Web.Security.WindowsTokenRoleProvider" />
</providers>
</roleManager>
</system.web>
</configuration>
Commenti
La classe WindowsTokenRoleProvider è un provider di appartenenza al ruolo di sola lettura che recupera le informazioni sui ruoli per un utente Windows in base ai gruppi di sicurezza di Windows. È più utile con le applicazioni ASP.NET che usano autenticazione di Windows modalità in cui le impostazioni di autenticazione IIS disabilitano l'autenticazione anonima. È possibile configurare ASP.NET applicazioni per consentire o negare l'accesso in base all'appartenenza di un utente a un determinato gruppo di Windows.
Non è possibile utilizzare la classe WindowsTokenRoleProvider per creare o eliminare ruoli o modificare l'appartenenza a un ruolo basato sull'appartenenza a Windows gruppo. Questa funzionalità viene gestita dal sistema operativo Windows. La WindowsTokenRoleProvider classe supporta solo i IsUserInRole metodi e GetRolesForUser della RoleProvider classe astratta.
Costruttori
| Nome | Descrizione |
|---|---|
| WindowsTokenRoleProvider() |
Crea un'istanza della classe WindowsTokenRoleProvider. |
Proprietà
| Nome | Descrizione |
|---|---|
| ApplicationName |
Ottiene o imposta il nome dell'applicazione. |
| Description |
Ottiene una breve descrizione descrittiva adatta per la visualizzazione negli strumenti di amministrazione o in altre interfacce utente. (Ereditato da ProviderBase) |
| Name |
Ottiene il nome descrittivo utilizzato per fare riferimento al provider durante la configurazione. (Ereditato da ProviderBase) |
Metodi
| Nome | Descrizione |
|---|---|
| AddUsersToRoles(String[], String[]) |
Questo metodo non è supportato dal provider di ruoli del token Windows. |
| CreateRole(String) |
Questo metodo non è supportato dal provider di ruoli del token Windows. |
| DeleteRole(String, Boolean) |
Questo metodo non è supportato dal provider di ruoli del token Windows. |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| FindUsersInRole(String, String) |
Questo metodo non è supportato dal provider di ruoli del token Windows. |
| GetAllRoles() |
Questo metodo non è supportato dal provider di ruoli del token Windows. |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetRolesForUser(String) |
Ottiene un elenco dei gruppi di Windows in cui si trova un utente. |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| GetUsersInRole(String) |
Questo metodo non è supportato dal provider di ruoli del token Windows. |
| Initialize(String, NameValueCollection) |
Inizializza il provider del ruolo token Windows con i valori delle proprietà specificati nel file di configurazione per l'applicazione ASP.NET. Questo metodo non deve essere usato direttamente dal codice. |
| IsUserInRole(String, String) |
Ottiene un valore che indica se l'utente specificato si trova nel gruppo di Windows specificato. |
| IsUserInRole(String, WindowsBuiltInRole) |
Ottiene un valore che indica se l'utente specificato si trova nel ruolo predefinito di Windows specificato. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| RemoveUsersFromRoles(String[], String[]) |
Questo metodo non è supportato dal provider di ruoli del token Windows. |
| RoleExists(String) |
Questo metodo non è supportato dal provider di ruoli del token Windows. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |