다음을 통해 공유


PrincipalPermissionAttribute 클래스

선언적 보안을 사용하여 PrincipalPermission에 대한 보안 동작을 코드에 적용할 수 있습니다. 이 클래스는 상속될 수 없습니다.

네임스페이스: System.Security.Permissions
어셈블리: mscorlib(mscorlib.dll)

구문

‘선언
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
<AttributeUsageAttribute(AttributeTargets.Class Or AttributeTargets.Method, AllowMultiple:=True, Inherited:=False)> _
Public NotInheritable Class PrincipalPermissionAttribute
    Inherits CodeAccessSecurityAttribute
‘사용 방법
Dim instance As PrincipalPermissionAttribute
[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method, AllowMultiple=true, Inherited=false)] 
public sealed class PrincipalPermissionAttribute : CodeAccessSecurityAttribute
[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[AttributeUsageAttribute(AttributeTargets::Class|AttributeTargets::Method, AllowMultiple=true, Inherited=false)] 
public ref class PrincipalPermissionAttribute sealed : public CodeAccessSecurityAttribute
/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method, AllowMultiple=true, Inherited=false) */ 
public final class PrincipalPermissionAttribute extends CodeAccessSecurityAttribute
SerializableAttribute 
ComVisibleAttribute(true) 
AttributeUsageAttribute(AttributeTargets.Class|AttributeTargets.Method, AllowMultiple=true, Inherited=false) 
public final class PrincipalPermissionAttribute extends CodeAccessSecurityAttribute

설명

PrincipalPermissionAttribute를 사용하여 해당 코드를 실행하고 있는 사용자가 지정된 역할에 속하거나 인증을 받도록 선언적으로 요청할 수 있습니다. Unrestricted를 사용하면 true로 설정된 Authenticated와 Null 참조(Visual Basic의 경우 Nothing)로 설정된 NameRolePrincipalPermission을 만들 수 있습니다.

선언을 허용하는 범위는 사용되는 SecurityAction에 따라 다릅니다. 어셈블리 수준에서는 PrincipalPermissionAttribute가 적용되지 않습니다.

보안 특성에 의해 선언된 보안 정보는 특성 대상의 메타데이터에 저장되며, 런타임에 시스템에서 액세스할 수 있습니다. 보안 특성은 선언적 보안에만 사용됩니다. 명령적 보안의 경우 해당하는 사용 권한 클래스를 사용합니다.

중요   보안 주체 권한을 요청하려면 먼저 현재 응용 프로그램 도메인의 보안 주체 정책을 WindowsPrincipal 열거형 값으로 설정해야 합니다. 기본적으로 보안 주체 정책은 UnauthenticatedPrincipal로 설정됩니다. 보안 주체 정책을 WindowsPrincipal로 설정하지 않으면 보안 주체 권한 요청이 실패합니다. 보안 주체 권한을 요청하기 전에 AppDomain.CurrentDomain.SetPrincipalPolicy(PrincipalPolicy.WindowsPrincipal). 코드를 실행해야 합니다.

예제

다음 예제에서는 PrincipalPermission을 선언적으로 사용하여 현재 사용자가 Bob이고 Supervisor 역할에 속하도록 요청하는 방법을 보여 줍니다.

<PrincipalPermissionAttribute(SecurityAction.Demand, _
 Name := "Bob", Role := "Supervisor")> Public Class SampleClass
[PrincipalPermissionAttribute(SecurityAction.Demand, Name="Bob",
Role="Supervisor")]
[PrincipalPermissionAttribute(SecurityAction::Demand,Name="Bob",
Role="Supervisor")]
/** @attribute PrincipalPermissionAttribute(SecurityAction.Demand,
    Name = "Bob", Role = "Supervisor")
 */

다음 예제에서는 역할 구성원에 상관 없이 현재 사용자의 ID가 Bob이 되도록 요청하는 방법을 보여 줍니다.

<PrincipalPermissionAttribute(SecurityAction.Demand, _
 Name := "Bob")> Public Class SampleClass
[PrincipalPermissionAttribute(SecurityAction.Demand, Name="Bob")]
[PrincipalPermissionAttribute(SecurityAction::Demand,Name="Bob")]
/** @attribute PrincipalPermissionAttribute(SecurityAction.Demand, Name = "Bob")
 */

다음 예제에서는 사용자가 인증되도록 요청하는 방법만을 보여 줍니다.

<PrincipalPermissionAttribute(SecurityAction.Demand, _
 Authenticated := True)> Public Class SampleClass
[PrincipalPermissionAttribute(SecurityAction.Demand, Authenticated=true)]
[PrincipalPermissionAttribute(SecurityAction::Demand,Authenticated=true)]
/** @attribute PrincipalPermissionAttribute(SecurityAction.Demand, 
    Authenticated = true)
 */

상속 계층 구조

System.Object
   System.Attribute
     System.Security.Permissions.SecurityAttribute
       System.Security.Permissions.CodeAccessSecurityAttribute
        System.Security.Permissions.PrincipalPermissionAttribute

스레드로부터의 안전성

이 형식의 모든 public static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework에서 모든 플래폼의 모든 버전을 지원하지는 않습니다. 지원되는 버전의 목록은 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

2.0, 1.1, 1.0에서 지원

참고 항목

참조

PrincipalPermissionAttribute 멤버
System.Security.Permissions 네임스페이스
PrincipalPermission 클래스

기타 리소스

특성을 사용하여 메타데이터 확장
보안 주체