PrincipalPermission Třída

Definice

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

Dědičnost

Object

PrincipalPermission

Atributy

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Implementuje

IPermission ISecurityEncodable IUnrestrictedPermission

Příklady

Následující příklad vyžaduje, aby byl aktivním objektem zabezpečení správce. Parametr name je null, který umožňuje každému uživateli, který je správcem, předat požadavek.

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

Poznámky

Předáním informací o identitě (uživatelské jméno a role) konstruktoru PrincipalPermission lze použít k vyžadování, aby identita aktivního objektu zabezpečení odpovídala tomuto údaji.

Aby se shodovaly aktivní IPrincipal a přidružené IIdentity, musí se shodovat zadaná identita i role. Pokud null se použije řetězec identity, interpretuje se jako požadavek, který odpovídá jakékoli identitě. null Použití řetězce role se bude shodovat s jakoukoli rolí. Z toho vyplývá, že předání null parametru pro name nebo role do PrincipalPermission bude odpovídat identitě a rolím v libovolném IPrincipalsouboru . Je také možné vytvořit entitu PrincipalPermission , která pouze určuje, zda IIdentity představuje ověřenou nebo neověřenou entitu. V tomto případě name a role jsou ignorovány.

Na rozdíl od většiny ostatních oprávnění neprodlužuje PrincipalPermission .CodeAccessPermission Implementuje však IPermission rozhraní. Důvodem je PrincipalPermission to, že se nejedná o přístupové oprávnění kódu; to znamená, že není uděleno na základě identity spouštěného sestavení. Místo toho umožňuje kódu provádět akce (Demand, Union, Intersectatd.) proti aktuální identitě uživatele způsobem, který je konzistentní se způsobem provádění těchto akcí pro přístup ke kódu a oprávnění identity kódu.

Konstruktory

Metody

Platí pro

Viz také

• PrincipalPermissionAttribute