WebPermission.AddPermission 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
以指定的存取權限將指定的 URI 加入至目前 WebPermission。
多載
AddPermission(NetworkAccess, String) |
以指定的存取權限將指定的 URI 字串加入至目前 WebPermission。 |
AddPermission(NetworkAccess, Regex) |
以指定的存取權限將指定的 URI 加入至目前 WebPermission。 |
AddPermission(NetworkAccess, String)
以指定的存取權限將指定的 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。
例外狀況
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 字串串, (AcceptList 或 ConnectList 以兩種方式) 。 首先,系統會根據適當的清單檢查候選 URI 字串;然後,如果沒有相符專案,候選 URI 字串會轉換成 Uri ,並針對適當的清單進行檢查。
另請參閱
適用於
AddPermission(NetworkAccess, Regex)
以指定的存取權限將指定的 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 集合。
例外狀況
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 以允許在uriRegex
PermissionState目標類別中使用 。 指定 Accept 作為 access
參數, uriRegex
將參數指定的 URI 新增至 URI 接受字串清單,或指定 Connect 為存取參數,以將 URI 新增至 URI 連接字串清單。
注意
在實例上UnrestrictedWebPermission呼叫AddPermission不會有任何作用,因為授與所有 URI 的許可權。
注意
建議您使用RegexOptions.IgnoreCase、 RegexOptions.Compiled與 RegexOptions.Singleline 旗標來建立 uriRegex
。
注意
系統會針對相關正則表示式清單檢查候選 URI 字串串, (AcceptList 或 ConnectList 以兩種方式) 。 首先,系統會根據適當的清單檢查候選 URI 字串;然後,如果沒有相符專案,候選 URI 字串會轉換成 Uri ,並針對適當的清單進行檢查。
另請參閱
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應