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)

來源:

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

注意

UnrestrictedWebPermission呼叫 AddPermission 將會沒有任何作用，因為許可權會授與所有URI。

注意

系統會以兩種方式檢查候選 URI 字串，以 (或 ConnectList) 相關的正則表示式AcceptList清單。 首先，系統會根據適當的清單檢查候選 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 為 PermissionState，請使用 AddPermission 來允許 uriRegex 在目標類別中使用 。 指定 Accept 為 access 參數，將參數所 uriRegex 指定的 URI 新增至 URI 接受字串清單，或指定 Connect 為存取參數，以將 URI 新增至 URI 連接字串清單。

注意

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

注意

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

注意

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

另請參閱

• NetworkAccess