PrincipalPermission Класс

Определение

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

Наследование

Object

PrincipalPermission

Атрибуты

ObsoleteAttribute SerializableAttribute ComVisibleAttribute

Реализации

IPermission ISecurityEncodable IUnrestrictedPermission

Примеры

В следующем примере требуется, чтобы активный субъект был администратором. Параметр name имеет значение null, который позволяет любому пользователю, являющемуся администратором, передать запрос.

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

Комментарии

Передавая сведения об удостоверении (имя пользователя и роль) конструктору, можно использовать для запроса на то, PrincipalPermission чтобы удостоверение активного участника соответствовало этим сведениям.

Чтобы сопоставить активный IPrincipal и связанный IIdentity, и указанное удостоверение и роль должны совпадать. Если null используется строка удостоверения, она интерпретируется как запрос на соответствие любому удостоверению. null Использование строки роли будет соответствовать любой роли. Неявно передача null параметра для name или role для будет соответствовать PrincipalPermission удостоверению и ролям в любом IPrincipal. Можно также создать PrincipalPermission объект , который только определяет, представляет ли IIdentity объект сущность с проверкой подлинности или сущность без проверки подлинности. В этом случае name и role игнорируются.

В отличие от большинства других разрешений, PrincipalPermission не расширяет .CodeAccessPermission Однако он реализует IPermission интерфейс . Это связано с тем, что PrincipalPermission не является разрешением на доступ к коду, то есть оно не предоставляется на основе удостоверения выполняющейся сборки. Вместо этого он позволяет коду выполнять действия (Demand, Union, Intersectи т. д.) с текущим удостоверением пользователя в соответствии с способом выполнения этих действий для доступа к коду и разрешений на идентификацию кода.

Конструкторы

Методы

Применяется к

См. также раздел

• PrincipalPermissionAttribute