IPermission.Union 메서드

아티클
08/21/2007

현재 사용 권한과 지정된 사용 권한의 합집합에 해당하는 사용 권한을 만듭니다.

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

구문

‘선언
Function Union ( _
    target As IPermission _
) As IPermission
‘사용 방법
Dim instance As IPermission
Dim target As IPermission
Dim returnValue As IPermission

returnValue = instance.Union(target)

IPermission Union (
    IPermission target
)

IPermission^ Union (
    IPermission^ target
)

IPermission Union (
    IPermission target
)

function Union (
    target : IPermission
) : IPermission

매개 변수

target
현재 사용 권한과 결합할 사용 권한입니다. 이 사용 권한은 현재 사용 권한과 형식이 같아야 합니다.

반환 값

현재 사용 권한과 지정된 사용 권한의 합집합에 해당하는 권한을 나타내는 새 사용 권한입니다.

예외

예외 형식	조건
ArgumentException	target 매개 변수가 Null 참조(Visual Basic의 경우 Nothing)이 아니고 현재 사용 권한과 형식이 다른 경우

설명

Union에 대한 호출 결과는 현재 사용 권한 및 지정된 사용 권한에 의해 나타나는 모든 작업을 나타내는 사용 권한입니다. 두 사용 권한 중 하나를 통과하는 요청은 두 사용 권한의 합집합에 해당하는 권한을 통과합니다.

다음 문은 Union 메서드의 모든 구현에 대해 참이어야 합니다. X 및 Y는 Null 참조(Visual Basic의 경우 Nothing)이 아닌 IPermission 개체를 나타냅니다.

X .Union( X )은 X와 값이 같은 개체를 반환합니다.
X .Union( Y )은 Y .Union( X )에서 반환한 개체와 값이 같은 개체를 반환합니다.
X .Union( Null 참조(Visual Basic의 경우 Nothing) )은 X와 값이 같은 개체를 반환합니다.

예제

다음 코드 예제에서는 Union 메서드를 구현하는 방법을 보여 줍니다. 이 코드 예제는 IPermission 클래스에 대해 제공되는 보다 큰 예제의 일부입니다.

// Return a new object that contains the union of 'this' and 'target'.
// Note: You do not have to implement this method. If you do not, the version
// in CodeAccessPermission does this:
//    1. If target is not null, a NotSupportedException is thrown.
//    2. If target is null, then Copy is called and the new object is returned.
public override IPermission Union(IPermission target) 
{
    // If 'target' is null, then return a copy of 'this'.
    if (target == null) return Copy();

    // Both objects must be the same type.
    SoundPermission soundPerm = VerifyTypeMatch(target);

    // If 'this' or 'target' are unrestricted, return a new unrestricted permission.
    if (m_specifiedAsUnrestricted || soundPerm.m_specifiedAsUnrestricted)
        return Clone(true, SoundPermissionState.PlayAnySound);

    // Return a new object with the calculated, unioned permission value.
    return Clone(false, (SoundPermissionState)
        Math.Max((Int32) m_flags, (Int32) soundPerm.m_flags));
}

    // Return a new object that contains the union of 'this' and 'target'.
    // Note: You do not have to implement this method. 
    // If you do not, the version
    // in CodeAccessPermission does this:
    //    1. If target is not null, a NotSupportedException is thrown.
    //    2. If target is null, then Copy is called and 
    //       the new object is returned.
public:
    virtual IPermission^ Union(IPermission^ target) override
    {
        // If 'target' is null, then return a copy of 'this'.
        if (target == nullptr)
        {
            return Copy();
        }

        // Both objects must be the same type.
        SoundPermission^ soundPerm = VerifyTypeMatch(target);

        // If 'this' or 'target' are unrestricted, 
        // return a new unrestricted permission.
        if (specifiedAsUnrestricted || soundPerm->specifiedAsUnrestricted)
        {
            return Clone(true, SoundPermissionState::PlayAnySound);
        }

        // Return a new object with the calculated, unioned permission value.
        return Clone(false, (SoundPermissionState)
            Math::Max((int) stateFlags, (int) soundPerm->stateFlags));
    }

플랫폼

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에서 지원

참고 항목

참조

IPermission 인터페이스
IPermission 멤버
System.Security 네임스페이스

다음을 통해 공유