IPermission.Union(IPermission) Metodo

Definizione

Spazio dei nomi:

System.Security

Assembly:

System.Runtime.dll

Crea un'autorizzazione che rappresenta l'unione dell'autorizzazione corrente e di quella specificata.

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

Parametri

target

IPermission

Autorizzazione da combinare con quella corrente. Deve essere dello stesso tipo dell'autorizzazione corrente.

Restituisce

IPermission

Nuova autorizzazione che rappresenta l'unione dell'autorizzazione corrente e di quella specificata.

Eccezioni

ArgumentException

Il parametro target non è null e non è dello stesso tipo dell'autorizzazione corrente.

Esempio

Nell'esempio di codice seguente viene illustrato l'implementazione del Union metodo. Questo esempio di codice fa parte di un esempio più grande fornito per la 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

Commenti

Il risultato di una chiamata a Union è un'autorizzazione che rappresenta tutte le operazioni rappresentate dall'autorizzazione corrente e dall'autorizzazione specificata. Tutte le richieste che superano l'autorizzazione superano l'unione.

Per tutte le implementazioni del Union metodo sono necessarie le istruzioni seguenti. X e Y rappresentano IPermission oggetti che non nullsono .

• X. Union(X) restituisce un oggetto con lo stesso valore di X.

• X. Union(Y) restituisce un oggetto con lo stesso valore dell'oggetto restituito da Y. Union(X).

• X. Union(null) restituisce un oggetto con lo stesso valore di X.