PrincipalPermissionAttribute Classe

Definizione

Consente di applicare azioni di sicurezza per PrincipalPermission al codice usando la sicurezza dichiarativa.Allows security actions for PrincipalPermission to be applied to code using declarative security. Questa classe non può essere ereditata.This class cannot be inherited.

public ref class PrincipalPermissionAttribute sealed : System::Security::Permissions::CodeAccessSecurityAttribute
[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Method, AllowMultiple=true, Inherited=false)]
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public sealed class PrincipalPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute
type PrincipalPermissionAttribute = class
    inherit CodeAccessSecurityAttribute
Public NotInheritable Class PrincipalPermissionAttribute
Inherits CodeAccessSecurityAttribute
Ereditarietà
Attributi

Esempi

Nell'esempio seguente viene illustrato il modo in cui la classe PrincipalPermissionAttribute viene utilizzata in modo dichiarativo per richiedere che l'utente corrente sia un amministratore.The following example demonstrates how the PrincipalPermissionAttribute class is used declaratively to demand that the current user be an administrator.

Nota

In Windows Vista, la funzionalità Controllo dell'account utente determina i privilegi di un utente.In Windows Vista, User Account Control (UAC) determines the privileges of a user. Ai membri del gruppo Administrators predefinito vengono assegnati due token di accesso in fase di esecuzione, ovvero un token di accesso utente standard e un token di accesso amministratore.If you are a member of the Built-in Administrators group, you are assigned two run-time access tokens: a standard user access token and an administrator access token. Per impostazione predefinita, viene assegnato il ruolo dell'utente standard.By default, you are in the standard user role. Per eseguire il codice che richiede un ruolo da amministratore è necessario elevare i privilegi da utente standard ad amministratore.To execute the code that requires you to be an administrator, you must first elevate your privileges from standard user to administrator. È possibile farlo quando si avvia un'applicazione facendo clic con il pulsante destro del mouse sull'icona dell'applicazione e indicando l'opzione di esecuzione come amministratore.You can do this when you start an application by right-clicking the application icon and indicating that you want to run as an administrator.

using namespace System;
using namespace System::Security;
using namespace System::Security::Permissions;
using namespace System::Security::Policy;
using namespace System::Security::Principal;

[PrincipalPermission(SecurityAction::Demand, Role = "Administrators")]
void CheckAdministrator()
{
    Console::WriteLine("User is an administrator.");
}
int main(array<System::String ^> ^args)
{
    try
    {
        // Must set PrincipalPolicy to WindowsPrincipal
        AppDomain::CurrentDomain->SetPrincipalPolicy(PrincipalPolicy::WindowsPrincipal);
        // Check using declarative security.
        CheckAdministrator();
        // Check using Imperative security.
        System::String^ null;
        PrincipalPermission^ principalPerm = gcnew PrincipalPermission(null, "Administrators" );
        principalPerm->Demand();
        Console::WriteLine("Demand succeeded");
    }
    catch (Exception ^e)
    {
        Console::WriteLine(e->Message);
    }
    return 0;
}


using System;
using System.Threading;
using System.Security.Permissions;
using System.Security.Principal;

class SecurityPrincipalDemo
{
    public static void Main()
    {
        try
        {
            // PrincipalPolicy must be set to WindowsPrincipal to check roles.
            AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal);
            // Check using the PrincipalPermissionAttribute
            CheckAdministrator();
            // Check using PrincipalPermission class.
            PrincipalPermission principalPerm = new PrincipalPermission(null, "Administrators");
            principalPerm.Demand();
            Console.WriteLine("Demand succeeded.");
        }
        catch (Exception e)
        {
            Console.WriteLine(e.Message);
        }
    }
    [PrincipalPermission(SecurityAction.Demand, Role = "Administrators")]
    static void CheckAdministrator()
    {
        Console.WriteLine("User is an administrator");
    }
}
Imports System.Threading
Imports System.Security.Permissions
Imports System.Security.Principal



Class SecurityPrincipalDemo

    Public Shared Sub Main()
        Try
            ' PrincipalPolicy must be set to WindowsPrincipal to check roles.
            AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal)
            ' Check using the PrincipalPermissionAttribute
            CheckAdministrator()
            ' Check using PrincipalPermission class.
            Dim principalPerm As New PrincipalPermission(Nothing, "Administrators")
            principalPerm.Demand()
            Console.WriteLine("Demand succeeded.")
        Catch e As Exception
            Console.WriteLine(e.Message)
        End Try

    End Sub

    <PrincipalPermission(SecurityAction.Demand, Role:="Administrators")> _
    Shared Sub CheckAdministrator()
        Console.WriteLine("User is an administrator")

    End Sub
End Class

Commenti

Importante

Il codice parzialmente attendibile non è più supportato.Partially trusted code is no longer supported. Questo attributo non ha alcun effetto in .NET Core.This attribute has no effect in .NET Core.

PrincipalPermissionAttribute può essere usato per richiedere in modo dichiarativo che gli utenti che eseguono il codice appartengano a un ruolo specificato o siano stati autenticati.PrincipalPermissionAttribute can be used to declaratively demand that users running your code belong to a specified role or have been authenticated. L'uso di Unrestricted crea un PrincipalPermission con Authenticated impostato su true e Name e Role impostati su null.Use of Unrestricted creates a PrincipalPermission with Authenticated set to true and Name and Role set to null.

L'ambito della dichiarazione consentita dipende dal SecurityAction utilizzato.The scope of the declaration that is allowed depends on the SecurityAction that is used. PrincipalPermissionAttribute non può essere applicato a livello di assembly.PrincipalPermissionAttribute cannot be applied at the assembly level.

Le informazioni di sicurezza dichiarate da un attributo di sicurezza vengono archiviate nei metadati della destinazione dell'attributo ed è possibile accedervi dal sistema in fase di esecuzione.The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Gli attributi di sicurezza vengono utilizzati solo per la sicurezza dichiarativa.Security attributes are used only for declarative security. Per la sicurezza imperativa, usare la classe di autorizzazioni corrispondente.For imperative security, use the corresponding permission class.

Importante

Prima di usare questa classe per richiedere l'autorizzazione dell'entità, è necessario impostare il criterio principale del dominio dell'applicazione corrente sul valore di enumerazione WindowsPrincipal.Before you use this class to demand principal permission, you must set the current application domain's principal policy to the enumeration value WindowsPrincipal. Per impostazione predefinita, il criterio principale è impostato su UnauthenticatedPrincipal.By default, the principal policy is set to UnauthenticatedPrincipal. Se non si impostano i criteri principale su WindowsPrincipal, una richiesta di autorizzazione dell'entità avrà esito negativo.If you do not set the principal policy to WindowsPrincipal, a demand for principal permission will fail. Il codice seguente deve essere eseguito prima che venga richiesta l'autorizzazione dell'entità: AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal).The following code should be executed before the principal permission is demanded: AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal).

Costruttori

PrincipalPermissionAttribute(SecurityAction)

Inizializza una nuova istanza della classe PrincipalPermissionAttribute con l'oggetto SecurityAction specificato.Initializes a new instance of the PrincipalPermissionAttribute class with the specified SecurityAction.

Proprietà

Action

Ottiene o imposta un'azione di sicurezza.Gets or sets a security action.

(Ereditato da SecurityAttribute)
Authenticated

Ottiene o imposta un valore che indica se l'entità corrente è stata autenticata dal sottostante provider di sicurezza basato sui ruoli.Gets or sets a value indicating whether the current principal has been authenticated by the underlying role-based security provider.

Name

Ottiene o imposta il nome dell'identità associato all'entità corrente.Gets or sets the name of the identity associated with the current principal.

Role

Ottiene o imposta l'appartenenza a un ruolo di sicurezza specificato.Gets or sets membership in a specified security role.

TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Ereditato da Attribute)
Unrestricted

Ottiene o imposta un valore che indica se esiste una dichiarazione di autorizzazione completa, ovvero senza restrizioni, alla risorsa protetta dall’attributo.Gets or sets a value indicating whether full (unrestricted) permission to the resource protected by the attribute is declared.

(Ereditato da SecurityAttribute)

Metodi

CreatePermission()

Crea e restituisce un nuovo oggetto PrincipalPermission.Creates and returns a new PrincipalPermission.

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Ereditato da Attribute)
GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Ereditato da Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Ereditato da Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Ereditato da Attribute)

Si applica a

Vedi anche