WebPermission.AddPermission 方法

定義

命名空間:

System.Net

組件:

System.Security.Permissions.dll

套件:

System.Security.Permissions v9.0.0-rc.2.24473.5

以指定的存取權限將指定的 URI 加入至目前 WebPermission。

多載

AddPermission(NetworkAccess, String)	以指定的存取權限將指定的 URI 字串加入至目前 WebPermission。
AddPermission(NetworkAccess, Regex)	以指定的存取權限將指定的 URI 加入至目前 WebPermission。

AddPermission(NetworkAccess, String)

來源:

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

NetworkAccess，指定要授與 URI 的存取權限。

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 連接字串清單。

注意

Unrestricted WebPermission呼叫 AddPermission 時不會有任何作用，因為許可權會授與所有 URI。

注意

系統會針對相關正則表示式清單檢查候選 URI 字串串， (AcceptList 或 ConnectList 以兩種方式) 。 首先，系統會根據適當的清單檢查候選 URI 字串;然後，如果沒有相符專案，候選 URI 字串會轉換成 Uri ，並針對適當的清單進行檢查。

另請參閱

• NetworkAccess

AddPermission(NetworkAccess, Regex)

來源:

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為 ，請使用 AddPermission 以允許在uriRegexPermissionState目標類別中使用 。 指定 Accept 作為 access 參數， uriRegex 將參數指定的 URI 新增至 URI 接受字串清單，或指定 Connect 為存取參數，以將 URI 新增至 URI 連接字串清單。

注意

在實例上UnrestrictedWebPermission呼叫AddPermission不會有任何作用，因為授與所有 URI 的許可權。

注意

建議您使用RegexOptions.IgnoreCase、 RegexOptions.Compiled與 RegexOptions.Singleline 旗標來建立 uriRegex 。

注意

系統會針對相關正則表示式清單檢查候選 URI 字串串， (AcceptList 或 ConnectList 以兩種方式) 。 首先，系統會根據適當的清單檢查候選 URI 字串;然後，如果沒有相符專案，候選 URI 字串會轉換成 Uri ，並針對適當的清單進行檢查。

另請參閱

• NetworkAccess