IPermission.Union(IPermission) Methode

Definition

Namespace:

System.Security

Assembly:

System.Runtime.dll

Assembly:

System.Runtime.Extensions.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Erstellt eine Berechtigung als Kombination der aktuellen und der angegebenen Berechtigung.

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

Parameter

target

IPermission

Eine Berechtigung, die mit der aktuellen Berechtigung kombiniert werden soll. Sie muss denselben Typ aufweisen wie die aktuelle Berechtigung.

Gibt zurück

IPermission

Eine neue Berechtigung, die die Kombination der aktuellen und der angegebenen Berechtigung darstellt.

Ausnahmen

ArgumentException

Der target-Parameter ist nicht null und weist nicht denselben Typ wie die aktuelle Berechtigung auf.

Beispiele

Im folgenden Codebeispiel wird die Implementierung der Union Methode veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die IPermission-Klasse bereitgestellt wird.

    // 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

Hinweise

Das Ergebnis eines Aufrufs Union ist eine Berechtigung, die alle Vorgänge darstellt, die sowohl durch die aktuelle Berechtigung als auch die angegebene Berechtigung dargestellt werden. Jede Anforderung, die beide Berechtigungen übergibt, übergibt ihre Union.

Die folgenden Anweisungen müssen für alle Implementierungen der Union Methode true sein. X und Y stellen Objekte dar IPermission , die nicht null.

• X. Union(X) gibt ein Objekt zurück, das denselben Wert wie X.

• X. Union(Y) gibt ein Objekt zurück, das denselben Wert wie das von Y. Union(X).

• X. Union(null) gibt ein Objekt zurück, das denselben Wert wie X.