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 角色字符串将匹配任何角色。 这意味着，将 name 或 role 的 null 参数传递给 PrincipalPermission 将匹配任何 IPrincipal中的标识和角色。 还可以构造一个 PrincipalPermission，该 PrincipalPermission 仅确定 IIdentity 是表示经过身份验证的还是未经身份验证的实体。 在这种情况下，将忽略 name 和 role。

与大多数其他权限不同，PrincipalPermission 不会扩展 CodeAccessPermission。 但是，它实现 IPermission 接口。 这是因为 PrincipalPermission 不是代码访问权限;也就是说，不会根据正在执行的程序集的标识授予它。 相反，它允许代码针对当前用户标识执行操作（Demand、Union、Intersect等），其方式与代码访问和代码标识权限执行这些操作的方式一致。

构造函数

方法

适用于

另请参阅

• PrincipalPermissionAttribute