UrlIdentityPermission 构造函数

定义

命名空间:

System.Security.Permissions

程序集:

System.Security.Permissions.dll

初始化 UrlIdentityPermission 类的新实例。

重载

UrlIdentityPermission(PermissionState)	使用指定的 UrlIdentityPermission 初始化 PermissionState 类的新实例。
UrlIdentityPermission(String)	初始化 UrlIdentityPermission 类的新实例，以表示 site 所描述的 URL 标识。

UrlIdentityPermission(PermissionState)

使用指定的 UrlIdentityPermission 初始化 PermissionState 类的新实例。

public:
 UrlIdentityPermission(System::Security::Permissions::PermissionState state);

public UrlIdentityPermission (System.Security.Permissions.PermissionState state);

new System.Security.Permissions.UrlIdentityPermission : System.Security.Permissions.PermissionState -> System.Security.Permissions.UrlIdentityPermission

Public Sub New (state As PermissionState)

参数

state

PermissionState

PermissionState 值之一。

例外

ArgumentException

state 参数不是 PermissionState 的有效值。

示例

以下示例演示构造函数的 UrlIdentityPermission.UrlIdentityPermission(PermissionState) 用法。

UrlIdentityPermission ^ permIdPerm2 = gcnew UrlIdentityPermission(PermissionState::None);

UrlIdentityPermission permIdPerm2 = new UrlIdentityPermission(PermissionState.None);

Dim permIdPerm2 As New UrlIdentityPermission(PermissionState.None)

注解

创建完全受限 () None 或 Unrestricted 权限。

注意

在.NET Framework版本 1.0 和 1.1 中，标识权限不能具有Unrestricted权限状态值。 从.NET Framework版本 2.0 开始，标识权限可以具有任何权限状态值。 这意味着在 2.0 及更高版本中，标识权限的行为与实现 IUnrestrictedPermission 接口的权限的行为相同。 也就是说，如果已向程序集授予完全信任，则无论程序集的标识如何，对标识的需求始终成功。

在.NET Framework版本 1.0 和 1.1 中，即使调用程序集完全受信任，对标识权限的要求也有效。 也就是说，尽管调用程序集具有完全信任，但如果程序集不符合所需的条件，则对标识权限的要求会失败。 从.NET Framework版本 2.0 开始，如果调用程序集具有完全信任，则对标识权限的要求无效。 这可确保所有权限的一致性，消除了将标识权限视为特殊情况。

UrlIdentityPermission(String)

初始化 UrlIdentityPermission 类的新实例，以表示 site 所描述的 URL 标识。

public:
 UrlIdentityPermission(System::String ^ site);

public UrlIdentityPermission (string site);

new System.Security.Permissions.UrlIdentityPermission : string -> System.Security.Permissions.UrlIdentityPermission

Public Sub New (site As String)

参数

site

String

URL 或通配符表达式。

例外

ArgumentNullException

site 参数为 null。

FormatException

site 参数的长度为零。

ArgumentException

site 参数的 URL、目录或的站点部分无效。

示例

以下示例演示构造函数的 UrlIdentityPermission.UrlIdentityPermission(String) 用法。

UrlIdentityPermission ^ permIdPerm1 = gcnew UrlIdentityPermission("http://www.fourthcoffee.com/process/");

UrlIdentityPermission permIdPerm1 = new UrlIdentityPermission("http://www.fourthcoffee.com/process/");

Dim permIdPerm1 As New UrlIdentityPermission("http://www.fourthcoffee.com/process/")

注解

考虑完整的 URL，包括 HTTP、HTTPS、FTP) 和 文件 (协议，例如： http://www.fourthcoffee.com/process/grind.htm/。

URL 可以完全匹配，也可以由最后位置的通配符匹配，例如： http://www.fourthcoffee.com/process/*。 URL 还可以在点分隔符处包含通配符 (“*”) 前缀。 例如，URL 名称字符串http://www.fourthcoffee.com/process/grind.htm/是 和 http://*.com/process/grind.htm/的http://*.fourthcoffee.com/process/grind.htm/子集。

注意

从 .NET Framework 版本 2.0 开始，出于性能原因，无效 URL 在创建新类实例时不会导致参数异常。 当执行 Union、Intersect 或 IsSubsetOf) (集操作之一时，将发生参数异常。 对权限的需求导致 IsSubsetOf 安全基础结构调用。 由于参数异常，需求将失败，从而导致 SecurityException 引发 。 在这种情况下，将看不到原始 ArgumentException 异常。