Windows apps
Collapse the table of content
Expand the table of content
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 (IPermission^)

 

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

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

public:
virtual IPermission^ Union(
	IPermission^ target
) override

Parameters

target
Type: System.Security::IPermission^

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

Return Value

Type: System.Security::IPermission^

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

Exception Condition
ArgumentException

The target parameter is not null 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.

System_CAPS_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.
void UnionDemo()
{
    Console::WriteLine("\n************************  Union() Demo *************************\n");

    UIPermission ^ uiPerm1 = gcnew UIPermission(UIPermissionWindow::SafeTopLevelWindows);
    UIPermission ^ uiPerm2 = gcnew UIPermission(UIPermissionWindow::SafeSubWindows);

    UIPermission ^ p3 = dynamic_cast<UIPermission^>(uiPerm1->Union(uiPerm2));
    Console::WriteLine("   The union of {0} and  \n\t{1} = {2} ", uiPerm1->Window,
                               uiPerm2->Window, (nullptr != p3)?p3->Window.ToString():"null");
}

.NET Framework
Available since 1.1
Return to top
Show:
© 2017 Microsoft