Defines the identity permission for the URL from which the code originates. This class cannot be inherited.
(in mscorlib.dll)
Visual Basic (Declaration)
<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class UrlIdentityPermission _
Inherits CodeAccessPermission
Dim instance As UrlIdentityPermission
[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class UrlIdentityPermission : CodeAccessPermission
[SerializableAttribute]
[ComVisibleAttribute(true)]
public ref class UrlIdentityPermission sealed : public CodeAccessPermission
public final class UrlIdentityPermission extends CodeAccessPermission
The complete URL is considered, including the protocol (HTTP, HTTPS, FTP) and the file. For example, http://www.fourthcoffee.com/process/grind.htm is a complete URL.
URLs can be matched exactly or by a wildcard in the final position, for example: http://www.fourthcoffee.com/process/*. URLs can also contain a wildcard ("*") prefix at the dot delimiter. For example, the URL name string http://www.fourthcoffee.com/process/grind.htm/ is a subset of http://*.fourthcoffee.com/process/grind.htm/ and http://*.com/process/grind.htm/.
.gif) Important Note: |
|---|
In the .NET Framework versions 1.0 and 1.1, demands on the identity permissions are effective even when the calling assembly is fully trusted. That is, although the calling assembly has full trust, a demand for an identity permission fails if the assembly does not meet the demanded criteria. In the .NET Framework version 2.0, demands for identity permissions are ineffective if the calling assembly has full trust. That is, a demand for an identity always succeeds, regardless of the identity of the assembly, if the assembly has been granted full trust. This assures consistency for all permissions, eliminating the treatment of identity permissions as a special case. |
In the .NET Framework versions 1.0 and 1.1, demands on the identity permissions are effective, even when the calling assembly is fully trusted. That is, although the calling assembly has full trust, a demand for an identity permission fails if the assembly does not meet the demanded criteria. In the .NET Framework version 2.0, demands for identity permissions are ineffective if the calling assembly has full trust. This assures consistency for all permissions, eliminating the treatment of identity permissions as a special case.
| Caution: |
|---|
UrlIdentityPermission grants permission for all paths to the file, including both the URL and the IP address. To Deny access to the file, you must Deny all possible paths to the file. For example, if http://www.fourthcoffee.com/process/grind.htm is located at IP address 192.168.238.241, to Deny access to http://www.fourthcoffee.com/process/grind.htm, you must Deny http://www.fourthcoffee.com/process/grind.htm, 192.168.238.241/grind.htm and any other path that you can use to access the code. Unfortunately, there are a myriad of ways URL paths can be phrased, so it is extremely difficult to block all paths through the use of Deny alone. A better technique to deal with multiple paths is to use a combination of PermitOnly and Deny. PermitOnly allows you to identify a finite set of URLs that you can provide access to, and then Deny allows you to explicitly select addresses from that set that you want to deny access to. For more information on this subject and the use of PermitOnly with Deny, see Canonicalization Problems Using Deny in the Using the Deny Method topic. |
.gif) Note: |
|---|
In the .NET Framework versions 1.0 and 1.1, identity permissions cannot have an Unrestricted permission state value. In the .NET Framework version 2.0, identity permissions can have any permission state value. This means that in version 2.0, identity permissions have the same behavior as permissions that implement the IUnrestrictedPermission interface. For information on executing version 2.0 applications with version 1.1 CAS policy, see <legacyV1CASPolicy> Element. |
The following code example shows the behavior of the UrlIdentityPermission class methods.
| Note: |
|---|
The code example is intended to show the behavior of the methods, not to demonstrate their use. In general, the methods of permission classes are used by the security infrastructure; they are not typically used in applications. Generally, only the constructors are used in application code. The created instance validates or controls resource access by using inherited CodeAccessPermission methods such as Demand. |
Imports System
Imports System.Security
Imports System.Security.Permissions
Public Class UrlIdentityPermissionDemo
Public Shared Sub Main(ByVal args() As String)
IsSubsetOfDemo()
CopyDemo()
UnionDemo()
IntersectDemo()
ToFromXmlDemo()
End Sub 'Main
' IsSubsetOf determines whether the current permission is a subset of the specified permission.
Private Shared Sub IsSubsetOfDemo()
Dim permIdPerm1 As New UrlIdentityPermission("http://www.fourthcoffee.com/process/")
Dim permIdPerm2 As New UrlIdentityPermission("http://www.fourthcoffee.com/*")
If permIdPerm1.IsSubsetOf(permIdPerm2) Then
Console.WriteLine(permIdPerm1.Url + " is a subset of " + permIdPerm2.Url)
Else
Console.WriteLine(permIdPerm1.Url + " is not a subset of " + permIdPerm2.Url)
End If
If permIdPerm2.IsSubsetOf(permIdPerm1) Then
Console.WriteLine(permIdPerm2.Url + " is a subset of " + permIdPerm1.Url)
Else
Console.WriteLine(permIdPerm2.Url + " is not a subset of " + permIdPerm1.Url)
End If
End Sub 'IsSubsetOfDemo
' Union creates a new permission that is the union of the current permission
' and the specified permission.
Private Shared Sub UnionDemo()
Dim permIdPerm1 As New UrlIdentityPermission("http://www.fourthcoffee.com/process/")
Dim permIdPerm2 As New UrlIdentityPermission("http://www.fourthcoffee.com/*")
Dim p3 As UrlIdentityPermission = CType(permIdPerm1.Union(permIdPerm2), UrlIdentityPermission)
Try
If Not (p3 Is Nothing) Then
Console.WriteLine("The union of " + permIdPerm1.Url + " and " + vbLf + vbTab + permIdPerm2.Url + " is " + vbLf + vbTab + p3.Url + vbLf)
Else
Console.WriteLine("The union of " + permIdPerm1.Url + " and " + vbLf + vbTab + permIdPerm2.Url + " is null." + vbLf)
End If
Catch e As SystemException
Console.WriteLine("The union of " + permIdPerm1.Url + " and " + vbLf + vbTab + permIdPerm2.Url + " failed.")
Console.WriteLine(e.Message)
End Try
End Sub 'UnionDemo
' Intersect creates and returns a new permission that is the intersection of the
' current permission and the permission specified.
Private Shared Sub IntersectDemo()
Dim permIdPerm1 As New UrlIdentityPermission("http://www.fourthcoffee.com/process/")
Dim permIdPerm2 As New UrlIdentityPermission("http://www.fourthcoffee.com/*")
Dim p3 As UrlIdentityPermission = CType(permIdPerm1.Intersect(permIdPerm2), UrlIdentityPermission)
If Not (p3 Is Nothing) Then
Console.WriteLine("The intersection of " + permIdPerm1.Url + " and " + vbLf + vbTab + permIdPerm2.Url + " is " + p3.Url + vbLf)
Else
Console.WriteLine("The intersection of " + permIdPerm1.Url + " and " + vbLf + vbTab + permIdPerm2.Url + " is null." + vbLf)
End If
End Sub 'IntersectDemo
'Copy creates and returns an identical copy of the current permission.
Private Shared Sub CopyDemo()
Dim permIdPerm1 As New UrlIdentityPermission("http://www.fourthcoffee.com/process/*")
Dim permIdPerm2 As New UrlIdentityPermission(PermissionState.None)
permIdPerm2 = CType(permIdPerm1.Copy(), UrlIdentityPermission)
If Not (permIdPerm2 Is Nothing) Then
Console.WriteLine("The copy succeeded: " + permIdPerm2.ToString() + " " + vbLf)
End If
End Sub 'CopyDemo
' ToXml creates an XML encoding of the permission and its current state; FromXml reconstructs a
' permission with the specified state from the XML encoding.
Private Shared Sub ToFromXmlDemo()
Dim permIdPerm1 As New UrlIdentityPermission("http://www.fourthcoffee.com/process/*")
Dim permIdPerm2 As New UrlIdentityPermission(PermissionState.None)
permIdPerm2.FromXml(permIdPerm1.ToXml())
Dim result As Boolean = permIdPerm2.Equals(permIdPerm1)
If result Then
Console.WriteLine("Result of ToFromXml = " + permIdPerm2.ToString())
Else
Console.WriteLine(permIdPerm2.ToString())
Console.WriteLine(permIdPerm1.ToString())
End If
End Sub 'ToFromXmlDemo
End Class 'UrlIdentityPermissionDemo
using System;
using System.Security;
using System.Security.Permissions;
public class UrlIdentityPermissionDemo
{
public static void Main(String[] args)
{
IsSubsetOfDemo();
CopyDemo();
UnionDemo();
IntersectDemo();
ToFromXmlDemo();
}
// IsSubsetOf determines whether the current permission is a subset of the specified permission.
private static void IsSubsetOfDemo()
{
UrlIdentityPermission permIdPerm1 = new UrlIdentityPermission("http://www.fourthcoffee.com/process/");
UrlIdentityPermission permIdPerm2 = new UrlIdentityPermission("http://www.fourthcoffee.com/*");
if (permIdPerm1.IsSubsetOf(permIdPerm2))
{
Console.WriteLine(permIdPerm1.Url + " is a subset of " + permIdPerm2.Url);
}
else
{
Console.WriteLine(permIdPerm1.Url + " is not a subset of " + permIdPerm2.Url);
}
if (permIdPerm2.IsSubsetOf(permIdPerm1))
{
Console.WriteLine(permIdPerm2.Url + " is a subset of " + permIdPerm1.Url);
}
else
{
Console.WriteLine(permIdPerm2.Url + " is not a subset of " + permIdPerm1.Url);
}
}
// Union creates a new permission that is the union of the current permission
// and the specified permission.
private static void UnionDemo()
{
UrlIdentityPermission permIdPerm1 = new UrlIdentityPermission("http://www.fourthcoffee.com/process/");
UrlIdentityPermission permIdPerm2 = new UrlIdentityPermission("http://www.fourthcoffee.com/*");
UrlIdentityPermission p3 = (UrlIdentityPermission)permIdPerm1.Union(permIdPerm2);
try
{
if (p3 != null)
{
Console.WriteLine("The union of " + permIdPerm1.Url +
" and \n\t" + permIdPerm2.Url + " is \n\t"
+ p3.Url + "\n");
}
else
{
Console.WriteLine("The union of " + permIdPerm1.Url +
" and \n\t" + permIdPerm2.Url + " is null.\n");
}
}
catch (SystemException e)
{
Console.WriteLine("The union of " + permIdPerm1.Url +
" and \n\t" + permIdPerm2.Url + " failed.");
Console.WriteLine(e.Message);
}
}
// Intersect creates and returns a new permission that is the intersection of the
// current permission and the permission specified.
private static void IntersectDemo()
{
UrlIdentityPermission permIdPerm1 = new UrlIdentityPermission("http://www.fourthcoffee.com/process/");
UrlIdentityPermission permIdPerm2 = new UrlIdentityPermission("http://www.fourthcoffee.com/*");
UrlIdentityPermission p3 = (UrlIdentityPermission)permIdPerm1.Intersect(permIdPerm2);
if (p3 != null)
{
Console.WriteLine("The intersection of " + permIdPerm1.Url + " and \n\t" +
permIdPerm2.Url + " is " + p3.Url + "\n");
}
else
{
Console.WriteLine("The intersection of " + permIdPerm1.Url +
" and \n\t" + permIdPerm2.Url + " is null.\n");
}
}
//Copy creates and returns an identical copy of the current permission.
private static void CopyDemo()
{
UrlIdentityPermission permIdPerm1 = new UrlIdentityPermission("http://www.fourthcoffee.com/process/*");
UrlIdentityPermission permIdPerm2 = new UrlIdentityPermission(PermissionState.None);
permIdPerm2 = (UrlIdentityPermission)permIdPerm1.Copy();
if (permIdPerm2 != null)
{
Console.WriteLine("The copy succeeded: " + permIdPerm2.ToString() + " \n");
}
}
// ToXml creates an XML encoding of the permission and its current state; FromXml reconstructs a
// permission with the specified state from the XML encoding.
private static void ToFromXmlDemo()
{
UrlIdentityPermission permIdPerm1 = new UrlIdentityPermission("http://www.fourthcoffee.com/process/*");
UrlIdentityPermission permIdPerm2 = new UrlIdentityPermission(PermissionState.None);
permIdPerm2.FromXml(permIdPerm1.ToXml());
bool result = permIdPerm2.Equals(permIdPerm1);
if (result)
{
Console.WriteLine("Result of ToFromXml = " + permIdPerm2.ToString());
}
else
{
Console.WriteLine(permIdPerm2.ToString());
Console.WriteLine(permIdPerm1.ToString());
}
}
}
using namespace System;
using namespace System::Security;
using namespace System::Security::Permissions;
using namespace System::Runtime::InteropServices;
void IsSubsetOfDemo(); // Forward references
void CopyDemo();
void UnionDemo();
void IntersectDemo();
void ToFromXmlDemo();
void main()
{
IsSubsetOfDemo();
CopyDemo();
UnionDemo();
IntersectDemo();
ToFromXmlDemo();
Console::WriteLine("\n\nPress ENTER to return");
Console::ReadLine();
}
// IsSubsetOf determines whether the current permission is a subset of the specified permission.
void IsSubsetOfDemo()
{
UrlIdentityPermission ^ permIdPerm1 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/process/");
UrlIdentityPermission ^ permIdPerm2 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/*");
if (permIdPerm1->IsSubsetOf(permIdPerm2))
Console::WriteLine(permIdPerm1->Url + " is a subset of " + permIdPerm2->Url);
else Console::WriteLine(permIdPerm1->Url + " is not a subset of " + permIdPerm2->Url);
if (permIdPerm2->IsSubsetOf(permIdPerm1))
Console::WriteLine(permIdPerm2->Url + " is a subset of " + permIdPerm1->Url);
else Console::WriteLine(permIdPerm2->Url + " is not a subset of " + permIdPerm1->Url);
}
// Union creates a gcnew permission that is the union of the current permission
// and the specified permission.
void UnionDemo()
{
UrlIdentityPermission ^ permIdPerm1 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/process/");
UrlIdentityPermission ^ permIdPerm2 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/*");
UrlIdentityPermission ^ p3 = (UrlIdentityPermission^)permIdPerm1->Union(permIdPerm2);
try
{
if (p3 != nullptr)
Console::WriteLine("The union of " + permIdPerm1->Url +
" and \n\t" + permIdPerm2->Url + " is \n\t" + p3->Url + "\n");
else Console::WriteLine("The union of " + permIdPerm1->Url +
" and \n\t" + permIdPerm2->Url + " is null.\n");
}
catch (SystemException ^ e)
{
Console::WriteLine("The union of " + permIdPerm1->Url +
" and \n\t" + permIdPerm2->Url + " failed.");
Console::WriteLine(e->Message);
}
}
// Intersect creates and returns a gcnew permission that is the intersection of the
// current permission and the permission specified.
void IntersectDemo()
{
UrlIdentityPermission ^ permIdPerm1 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/process/");
UrlIdentityPermission ^ permIdPerm2 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/*");
UrlIdentityPermission ^ p3 = (UrlIdentityPermission^)permIdPerm1->Intersect(permIdPerm2);
if (p3 != nullptr)
Console::WriteLine("The intersection of " + permIdPerm1->Url + " and \n\t" +
permIdPerm2->Url + " is " + p3->Url + "\n");
else Console::WriteLine("The intersection of " + permIdPerm1->Url +
" and \n\t" + permIdPerm2->Url + " is null.\n");
}
//Copy creates and returns an identical copy of the current permission.
void CopyDemo()
{
UrlIdentityPermission ^ permIdPerm1 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/process/*");
UrlIdentityPermission ^ permIdPerm2 = gcnew UrlIdentityPermission(PermissionState::None);
permIdPerm2 = (UrlIdentityPermission^)permIdPerm1->Copy();
if (permIdPerm2)
Console::WriteLine("The copy succeeded: " + permIdPerm2->ToString() + " \n");
}
// ToXml creates an XML encoding of the permission and its current state; FromXml reconstructs a
// permission with the specified state from the XML encoding.
void ToFromXmlDemo()
{
UrlIdentityPermission ^ permIdPerm1 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/process/*");
UrlIdentityPermission ^ permIdPerm2 = gcnew UrlIdentityPermission(PermissionState::None);
permIdPerm2->FromXml(permIdPerm1->ToXml());
bool result = permIdPerm2->Equals(permIdPerm1);
if (result)
Console::WriteLine("Result of ToFromXml = " + permIdPerm2->ToString());
else
{
Console::WriteLine(permIdPerm2->ToString());
Console::WriteLine(permIdPerm1->ToString());
}
}
System..::.Object
System.Security..::.CodeAccessPermission
System.Security.Permissions..::.UrlIdentityPermission
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
.NET Framework
Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Reference
Other Resources