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使用角色字串將會符合任何角色。 藉由隱含，傳遞 nullname 或 role 的參數 PrincipalPermission 會符合任何 IPrincipal中的身分識別和角色。 您也可以建構 PrincipalPermission ，只判斷 IIdentity 是否代表已驗證或未驗證的實體。 在這裡情況下， name 會忽略 和 role 。

不同於大部分的其他許可權， PrincipalPermission 不會擴充 CodeAccessPermission。 不過，它會實作 IPermission 介面。 這是因為 PrincipalPermission 不是因為 不是因為程式代碼訪問許可權，也就是說，不會根據執行元件的身分識別來授與它。 相反地，它允許程式代碼針對目前使用者身分識別執行動作 (Demand、 Union、 Intersect) 等等，以符合這些動作執行程式碼存取和程式碼身分識別許可權的方式。

建構函式

方法

適用於

另請參閱

• PrincipalPermissionAttribute