PrincipalPermission Classe

Définition

public ref class PrincipalPermission sealed : System::Security::IPermission, System::Security::Permissions::IUnrestrictedPermission

[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class PrincipalPermission : 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

public sealed class PrincipalPermission : System.Security.IPermission, System.Security.Permissions.IUnrestrictedPermission

[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type PrincipalPermission = class
    interface IPermission
    interface ISecurityEncodable
    interface 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

type PrincipalPermission = class
    interface IPermission
    interface ISecurityEncodable
    interface IUnrestrictedPermission

Public NotInheritable Class PrincipalPermission
Implements IPermission, IUnrestrictedPermission

Héritage

Object

PrincipalPermission

Attributs

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Implémente

IPermission ISecurityEncodable IUnrestrictedPermission

Exemples

L’exemple suivant exige que le principal actif soit un administrateur. Le name paramètre est null, ce qui permet à tout utilisateur administrateur de passer la demande.

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

int main(array<System::String ^> ^args)
{
    System::String^ null;
    AppDomain::CurrentDomain->SetPrincipalPolicy(PrincipalPolicy::WindowsPrincipal);
    PrincipalPermission^ principalPerm = gcnew PrincipalPermission(null, "Administrators" );
      principalPerm->Demand();
      Console::WriteLine("Demand succeeded");
    return 0;
}

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

class SecurityPrincipalDemo
{

    public static void Main()
    {
        AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal);
        PrincipalPermission principalPerm = new PrincipalPermission(null, "Administrators");
        principalPerm.Demand();
        Console.WriteLine("Demand succeeded.");
    }
}

Imports System.Threading
Imports System.Security.Permissions
Imports System.Security.Principal



Class SecurityPrincipalDemo


    Public Shared Sub Main()
        AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal)
        Dim principalPerm As New PrincipalPermission(Nothing, "Administrators")
        principalPerm.Demand()
        Console.WriteLine("Demand succeeded.")

    End Sub
End Class

Remarques

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

Pour faire correspondre les valeurs actives IPrincipal et associées 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 une identité. L’utilisation de la chaîne de null rôle correspond à n’importe quel rôle. Par implication, le passage null du paramètre pour name ou role à correspondra à PrincipalPermission l’identité et aux rôles dans n’importe quel IPrincipal. Il est également possible de construire un PrincipalPermission qui détermine uniquement si représente IIdentity une entité authentifiée ou non authentifiée. Dans ce cas, name et role sont ignorés.

Contrairement à la plupart des autres autorisations, PrincipalPermission n’étend CodeAccessPermissionpas . Toutefois, il implémente l’interface IPermission . En effet, 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 d’une manière cohérente avec la façon dont ces actions sont effectuées pour l’accès au code et les autorisations d’identité de code.

Constructeurs

Méthodes

S’applique à

Voir aussi

• PrincipalPermissionAttribute