SiteIdentityPermission.Union(IPermission) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Creates a permission that is the union of the current permission and the specified permission.
public:
override System::Security::IPermission ^ Union(System::Security::IPermission ^ target);
public override System.Security.IPermission Union (System.Security.IPermission target);
override this.Union : System.Security.IPermission -> System.Security.IPermission
Public Overrides Function Union (target As IPermission) As IPermission
Parameters
- target
- IPermission
A permission to combine with the current permission. It must be of the same type as the current permission.
Returns
A new permission that represents the union of the current permission and the specified permission.
Exceptions
The target
parameter is not null
and is not of the same type as the current permission.
-or-
The permissions are not equal and one is not a subset of the other.
Remarks
The result of a call to Union is a permission that represents all the sites represented by both the current permission and the specified permission. Any demand that passes either permission passes their union. For example, the union of a permission that represents access to www.fourthcoffee.com
and one that represents access to *.fourthcoffee.com
is a permission that represents access to *.fourthcoffee.com
.
The union of a permission and null
is the permission that is not null
. The union of a permission and a subset of that permission is the permission that contains the subset. Any other combination results in an ArgumentException being thrown. For example, the union of the site identity www.fourthcoffee.com
and the site identity www.tailspintoys.com
results in an exception because neither is a subset of the other.