PrincipalPermission Classe

Définition

Espace de noms:
System.Security.Permissions
Assembly:
mscorlib.dll

Autorise les vérifications sur le principal actif (voir IPrincipal) à l’aide des constructions de langage définies pour les actions de sécurité déclaratives et impératives. Cette classe ne peut pas être héritée.

public ref class PrincipalPermission sealed : System::Security::IPermission, System::Security::Permissions::IUnrestrictedPermission
[System.Serializable]
public sealed class PrincipalPermission : System.Security.IPermission, System.Security.Permissions.IUnrestrictedPermission
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class PrincipalPermission : System.Security.IPermission, System.Security.Permissions.IUnrestrictedPermission
[<System.Serializable>]
type PrincipalPermission = class
    interface IPermission
    interface IUnrestrictedPermission
    interface ISecurityEncodable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type PrincipalPermission = class
    interface IPermission
    interface IUnrestrictedPermission
    interface ISecurityEncodable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type PrincipalPermission = class
    interface IPermission
    interface ISecurityEncodable
    interface IUnrestrictedPermission
Public NotInheritable Class PrincipalPermission
Implements IPermission, IUnrestrictedPermission
Héritage
Object
PrincipalPermission
Attributs
SerializableAttribute ComVisibleAttribute
Implémente
IPermission ISecurityEncodable IUnrestrictedPermission

Remarques

Avertissement

La sécurité d’accès du code (CAS) a été déconseillée dans toutes les versions du .NET Framework et de .NET. Les versions récentes de .NET n’honorent pas les annotations CAS et produisent des erreurs si les API liées à CAS sont utilisées. Les développeurs doivent rechercher d’autres moyens d’accomplir des tâches de sécurité.

En passant des informations d’identité (nom d’utilisateur et rôle) au constructeur, PrincipalPermission vous pouvez l’utiliser pour demander que l’identité du principal actif corresponde à ces informations.

Pour correspondre à l’identité active IPrincipal et associée IIdentity, l’identité et le rôle spécifiés doivent correspondre. Si null la chaîne d’identité est utilisée, elle est interprétée comme une demande de correspondance avec n’importe quelle identité. L’utilisation de la chaîne de rôle correspond à n’importe null quel rôle. Par implication, le passage null du paramètre pour name ou role pour correspondre à PrincipalPermission l’identité et aux rôles dans n’importe quel IPrincipal. Il est également possible de construire une PrincipalPermission entité qui détermine uniquement si la IIdentity représente une entité authentifiée ou non authentifiée. Dans ce cas, name et role sont ignorés.

Contrairement à la plupart des autres autorisations, PrincipalPermission ne s’étend CodeAccessPermissionpas . Toutefois, il implémente l’interface IPermission . Cela est dû au fait qu’il PrincipalPermission ne s’agit pas d’une autorisation d’accès au code ; autrement dit, elle n’est pas accordée en fonction de l’identité de l’assembly en cours d’exécution. Au lieu de cela, il permet au code d’effectuer des actions (Demand, Union, Intersectet ainsi de suite) sur l’identité utilisateur actuelle de manière cohérente avec la façon dont ces actions sont effectuées pour les autorisations d’accès au code et d’identité de code.

Important

Avant une demande d’autorisation de principal, il est nécessaire de définir la stratégie de principal du domaine d’application actuelle sur la valeur WindowsPrincipald’énumération. Par défaut, la stratégie de principal est définie sur UnauthenticatedPrincipal. Si vous ne définissez pas la stratégie de principal WindowsPrincipalsur , une demande d’autorisation de principal échoue. Le code suivant doit être exécuté avant la demande de l’autorisation du principal :

AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal).

Constructeurs

Nom Description
PrincipalPermission(PermissionState)

Initialise une nouvelle instance de la PrincipalPermission classe avec le fichier spécifié PermissionState.
PrincipalPermission(String, String, Boolean)

Initialise une nouvelle instance de la PrincipalPermission classe pour l’état d’authentification , roleet spécifiéname.
PrincipalPermission(String, String)

Initialise une nouvelle instance de la PrincipalPermission classe pour le fichier spécifié name et role.

Méthodes

Nom Description
Copy()

Crée et retourne une copie identique de l’autorisation actuelle.
Demand()

Détermine au moment de l’exécution si le principal actuel correspond au principal spécifié par l’autorisation actuelle.
Equals(Object)

Détermine si l’objet spécifié PrincipalPermission est égal à l’objet actuel PrincipalPermission.
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
FromXml(SecurityElement)

Reconstruit une autorisation avec un état spécifié à partir d’un encodage XML.
GetHashCode()

Obtient un code de hachage pour l’objet PrincipalPermission qui convient pour une utilisation dans les algorithmes de hachage et les structures de données comme une table de hachage.
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
Intersect(IPermission)

Crée et retourne une autorisation qui est l’intersection de l’autorisation actuelle et de l’autorisation spécifiée.
IsSubsetOf(IPermission)

Détermine si l’autorisation actuelle est un sous-ensemble de l’autorisation spécifiée.
IsUnrestricted()

Retourne une valeur indiquant si l’autorisation actuelle est illimitée.
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
ToString()

Crée et retourne une chaîne représentant l’autorisation actuelle.
ToXml()

Crée un encodage XML de l’autorisation et de son état actuel.
Union(IPermission)

Crée une autorisation qui correspond à l’union de l’autorisation actuelle et de l’autorisation spécifiée.

S’applique à

Voir aussi