Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

UIPermission.Union Method

Creates a permission that is the union of the permission and the specified permission.

Namespace: System.Security.Permissions
Assembly: mscorlib (in mscorlib.dll)

public override IPermission Union (
	IPermission target
)
public IPermission Union (
	IPermission target
)
public override function Union (
	target : IPermission
) : IPermission
Not applicable.

Parameters

target

A permission to combine with the current permission. It must be the same type as the current permission.

Return Value

A new permission that represents the union of the current permission and the specified permission.

Exception typeCondition

ArgumentException

The target parameter is not a null reference (Nothing in Visual Basic) and is not of the same type as the current permission.

The result of a call to Union is a permission that represents all the operations represented by the current permission as well as all the operations represented by the specified permission. Specifically, it represents the most permissive values of UIPermissionWindow and UIPermissionClipboard from those in the current permission and the specified permission.

The following code example shows the behavior of the Union method. This example is part of a larger example provided for the UIPermission class.

NoteNote:

The code example is intended to show the behavior of the method, not to demonstrate its use. In general, the methods of permission classes are used by the security infrastructure; they are not typically used in applications.

// Union creates a new permission that is the union of the current permission
// and the specified permission.
private static void UnionDemo()
{
    UIPermission uiPerm1 = new UIPermission(UIPermissionWindow.SafeTopLevelWindows);
    UIPermission uiPerm2 = new UIPermission(UIPermissionWindow.SafeSubWindows);
    UIPermission p3 = (UIPermission)uiPerm1.Union(uiPerm2);
    try
    {
        if (p3 != null)
        {
            Console.WriteLine("The union of " + uiPerm1.Window.ToString() +
                " and \n\t" + uiPerm2.Window.ToString() + " is \n\t"
                + p3.Window.ToString() + "\n");

        }
        else
        {
            Console.WriteLine("The union of " + uiPerm1.Window.ToString() +
                " and \n\t" + uiPerm2.Window.ToString() + " is null.\n");
        }
    }
    catch (SystemException e)
    {
        Console.WriteLine("The union of " + uiPerm1.Window.ToString() +
                " and \n\t" + uiPerm2.Window.ToString() + " failed.");

        Console.WriteLine(e.Message);
    }

}

Windows 98, Windows Server 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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft