WebPermission.AddPermission 方法

定义

命名空间:

System.Net

程序集:

System.Security.Permissions.dll

包:

System.Security.Permissions v8.0.0

将具有指定访问权限的指定 URI 添加到当前 WebPermission。

重载

AddPermission(NetworkAccess, String)	将具有指定访问权限的指定 URI 字符串添加到当前 WebPermission。
AddPermission(NetworkAccess, Regex)	将具有指定访问权限的指定 URI 添加到当前 WebPermission。

AddPermission(NetworkAccess, String)

Source:

WebPermission.cs

将具有指定访问权限的指定 URI 字符串添加到当前 WebPermission。

public:
 void AddPermission(System::Net::NetworkAccess access, System::String ^ uriString);

public void AddPermission (System.Net.NetworkAccess access, string uriString);

member this.AddPermission : System.Net.NetworkAccess * string -> unit

Public Sub AddPermission (access As NetworkAccess, uriString As String)

参数

access

NetworkAccess

指定授予 URI 的访问权限的 NetworkAccess。

uriString

String

一个字符串，描述向其授予访问权限的 URI。

例外

ArgumentNullException

uriString 为 null。

示例

以下示例演示如何向特定 URL 字符串添加访问权限。

// Allow access to the first set of resources.
myWebPermission1->AddPermission( NetworkAccess::Connect, "http://www.contoso.com/default.htm" );
myWebPermission1->AddPermission( NetworkAccess::Connect, "http://www.adventure-works.com/default.htm" );

// Check whether if the callers higher in the call stack have been granted
// access permissions.
myWebPermission1->Demand();

  // Allow access to the first set of resources.
  myWebPermission1.AddPermission(NetworkAccess.Connect,"http://www.contoso.com/default.htm");
  myWebPermission1.AddPermission(NetworkAccess.Connect,"http://www.adventure-works.com/default.htm");

  // Check whether if the callers higher in the call stack have been granted 
  // access permissions.
  myWebPermission1.Demand();

' Allow access to the first set of resources.
myWebPermission1.AddPermission(NetworkAccess.Connect, "http://www.contoso.com/default.htm")
myWebPermission1.AddPermission(NetworkAccess.Connect, "http://www.adventure-works.com/default.htm")

' Check whether if the callers higher in the call stack have been granted 
' access permissions.
myWebPermission1.Demand()

注解

如果已将 指定 None 为 PermissionState，请使用 AddPermission 以允许 uriString 在目标类中使用 。 目标类可以使用 的方式 uriString 由 access指定。 指定 Accept 为访问参数，以将 参数指定的 uriString URI 添加到 URI 接受字符串列表，或指定 Connect 为访问参数以将 URI 添加到 URI 连接字符串列表。

注意

调用 AddPermission 将 UnrestrictedWebPermission 不起作用，因为会向所有 URI 授予权限。

注意

根据相关正则表达式列表检查候选 URI 字符串， (AcceptList 或 ConnectList) 两种方式。 首先，根据相应的列表检查候选 URI 字符串;然后，如果没有匹配项，则候选 URI 字符串将转换为 ， Uri 并针对相应的列表进行检查。

另请参阅

• NetworkAccess

AddPermission(NetworkAccess, Regex)

Source:

WebPermission.cs

将具有指定访问权限的指定 URI 添加到当前 WebPermission。

public:
 void AddPermission(System::Net::NetworkAccess access, System::Text::RegularExpressions::Regex ^ uriRegex);

public void AddPermission (System.Net.NetworkAccess access, System.Text.RegularExpressions.Regex uriRegex);

member this.AddPermission : System.Net.NetworkAccess * System.Text.RegularExpressions.Regex -> unit

Public Sub AddPermission (access As NetworkAccess, uriRegex As Regex)

参数

access

NetworkAccess

一个 NetworkAccess，指定授予 URI 的访问权限。

uriRegex

Regex

一个正则表达式，描述向其授予访问权限的 URI 集。

例外

ArgumentNullException

uriRegex 参数为 null。

示例

以下示例使用 AddPermission 为指定 URI 授予访问权限。

// Create a WebPermission.
WebPermission^ myWebPermission1 = gcnew WebPermission;

// Allow Connect access to the specified URLs.
myWebPermission1->AddPermission( NetworkAccess::Connect, gcnew Regex( "http://www\\.contoso\\.com/.*",
   (RegexOptions)(RegexOptions::Compiled | RegexOptions::IgnoreCase | RegexOptions::Singleline) ) );

myWebPermission1->Demand();

// Create a WebPermission.
WebPermission myWebPermission1 = new WebPermission();

// Allow Connect access to the specified URLs.
myWebPermission1.AddPermission(NetworkAccess.Connect,new Regex("http://www\\.contoso\\.com/.*", 
  RegexOptions.Compiled | RegexOptions.IgnoreCase | RegexOptions.Singleline));
 
myWebPermission1.Demand();

' Create a WebPermission.
Dim myWebPermission1 As New WebPermission()

' Allow Connect access to the specified URLs.
myWebPermission1.AddPermission(NetworkAccess.Connect, New Regex("http://www\.contoso\.com/.*", RegexOptions.Compiled Or RegexOptions.IgnoreCase Or RegexOptions.Singleline))

myWebPermission1.Demand()

注解

如果已将 指定 None 为 PermissionState，请使用 AddPermission 以允许 uriRegex 在目标类中使用 。 指定 Accept 为 access 参数，以将 参数指定的 uriRegex URI 添加到 URI 接受字符串列表，或指定 Connect 为访问参数以将 URI 添加到 URI 连接字符串列表。

注意

AddPermission当向所有 URI 授予权限时，对UnrestrictedWebPermission实例调用将不起作用。

注意

建议使用 RegexOptions.IgnoreCase、 RegexOptions.Compiled和 RegexOptions.Singleline 标志进行创建uriRegex。

注意

根据相关正则表达式列表检查候选 URI 字符串， (AcceptList 或 ConnectList) 两种方式。 首先，根据相应的列表检查候选 URI 字符串;然后，如果没有匹配项，则候选 URI 字符串将转换为 ， Uri 并针对相应的列表进行检查。

另请参阅

• NetworkAccess