PrincipalPermission Klasse

Definition

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

Vererbung

Object

PrincipalPermission

Attribute

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Implementiert

IPermission ISecurityEncodable IUnrestrictedPermission

Beispiele

Im folgenden Beispiel muss der aktive Prinzipal ein Administrator sein. Der parameter name ist null, wodurch jeder Benutzer, der administrator ist, die Anforderung übergeben kann.

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

Hinweise

Durch das Übergeben von Identitätsinformationen (Benutzername und Rolle) an den Konstruktor können PrincipalPermission verwendet werden, um zu verlangen, dass die Identität des aktiven Prinzipals mit diesen Informationen übereinstimmt.

Um dem aktiven IPrincipal und dem zugeordneten IIdentityzu entsprechen, muss sowohl die angegebene Identität als auch die rolle übereinstimmen. Wenn null Identitätszeichenfolge verwendet wird, wird sie als Anforderung interpretiert, um einer Identität zu entsprechen. Die Verwendung von null Rollenzeichenfolge entspricht jeder Rolle. ImPlikation entspricht die Übergabe null Parameters für name oder role an PrincipalPermission der Identität und den Rollen in allen IPrincipal. Es ist auch möglich, eine PrincipalPermission zu erstellen, die nur bestimmt, ob die IIdentity eine authentifizierte oder nicht authentifizierte Entität darstellt. In diesem Fall werden name und role ignoriert.

Im Gegensatz zu den meisten anderen Berechtigungen erweitert PrincipalPermission nicht CodeAccessPermission. Sie implementiert jedoch die IPermission Schnittstelle. Dies liegt daran, dass PrincipalPermission keine Codezugriffsberechtigung ist; d. h., sie wird nicht basierend auf der Identität der ausgeführten Assembly gewährt. Stattdessen ermöglicht es Code, Aktionen (Demand, Union, Intersectusw.) mit der aktuellen Benutzeridentität in übereinstimmung mit der Art und Weise auszuführen, wie diese Aktionen für Codezugriffs- und Codeidentitätsberechtigungen ausgeführt werden.

Konstruktoren

Methoden

Gilt für:

Weitere Informationen

• PrincipalPermissionAttribute