IPermission.Union(IPermission) Método

Definição

Namespace:

System.Security

Assembly:

System.Runtime.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Cria uma permissão que é a união entre a permissão atual e a permissão especificada.

public:
 System::Security::IPermission ^ Union(System::Security::IPermission ^ target);

public System.Security.IPermission Union (System.Security.IPermission target);

public System.Security.IPermission? Union (System.Security.IPermission? target);

abstract member Union : System.Security.IPermission -> System.Security.IPermission

Public Function Union (target As IPermission) As IPermission

Parâmetros

target

IPermission

Uma permissão a ser combinada com a permissão atual. Ele deve ser do mesmo tipo da permissão atual.

Retornos

IPermission

Uma nova permissão que representa a união da permissão atual e da permissão especificada.

Exceções

ArgumentException

O parâmetro target não é null e não é do mesmo tipo que a permissão atual.

Exemplos

O exemplo de código a seguir demonstra a implementação do Union método. Este exemplo de código faz parte de um exemplo maior fornecido para a IPermission classe.

    // 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));
    }

// 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 Overrides Function Union(ByVal target As IPermission) As IPermission
    ' If 'target' is null, then return a copy of 'this'.
    If target Is Nothing Then
        Return Copy()
    End If
    ' Both objects must be the same type.
    Dim soundPerm As SoundPermission = VerifyTypeMatch(target)

    ' If 'this' or 'target' are unrestricted, return a new unrestricted permission.
    If m_specifiedAsUnrestricted OrElse soundPerm.m_specifiedAsUnrestricted Then
        Return Clone(True, SoundPermissionState.PlayAnySound)
    End If
    ' Return a new object with the calculated, unioned permission value.
    Return Clone(False, CType(Math.Max(CType(m_flags, Int32), CType(soundPerm.m_flags, Int32)), SoundPermissionState))

End Function 'Union

Comentários

O resultado de uma chamada Union é uma permissão que representa todas as operações representadas pela permissão atual e pela permissão especificada. Qualquer exigência que passe qualquer permissão passa em sua união.

As instruções a seguir são necessárias para serem verdadeiras para todas as implementações do Union método. X e Y representar IPermission objetos que não nullsão .

• X. Union(X) retorna um objeto que tem o mesmo valor que X.

• X. Union(Y) retorna um objeto que tem o mesmo valor que o objeto retornado por Y. Union(X).

• X. Union(null) retorna um objeto que tem o mesmo valor que X.