WebPermission 類別

定義

命名空間:

System.Net

組件:

System.Security.Permissions.dll

來源:

WebPermission.cs

警告

Code Access Security is not supported or honored by the runtime.

控制存取 HTTP 網際網路資源的權利。

public ref class WebPermission sealed : System::Security::CodeAccessPermission, System::Security::Permissions::IUnrestrictedPermission

[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class WebPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission

[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type WebPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

Public NotInheritable Class WebPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission

繼承

Object

CodeAccessPermission

WebPermission

屬性

ObsoleteAttribute

實作

IUnrestrictedPermission

備註

謹慎

程式碼存取安全（CAS）已在所有版本的 .NET Framework 與 .NET 中被棄用。 最新版本的 .NET 不承認 CAS 標註，若使用 CAS 相關 API，則會產生錯誤。 開發人員應尋求其他方法來完成安全任務。

WebPermission 提供一組方法與屬性來控制對網際網路資源的存取。 你可以用 來WebPermission根據創建時WebPermission設定的資源，提供有限制或無限制的存取PermissionState權限。

透過呼叫其建構子，使用以下參數之一來建立 WebPermission 實例：

• 無參數。 預設的 PermissionState 是 None。

• A PermissionState。 指定 Unrestricted 允許目標類別中使用任何 URI，或 None 只允許透過該方法存取你指定的 AddPermission URI。

• 一個 NetworkAccess 值和一個 URI 字串。 指定的 URI 會由該值授予 NetworkAccess 權限。

• 一個 NetworkAccess 指定符與 URI 正則表達式。

然後ConnectListAcceptList持有你已授權存取權限的 URI。 要將 URI 加入這些清單中的任一，請使用 AddPermission。 如果你將參數作為 ， AcceptNetworkAccess URI 會被加入 AcceptList。 WebPermission 會允許連接到你的目標類別，且 URI 與 AcceptList。

謹慎

要拒絕存取網際網路資源，必須拒絕所有可能通往該資源的路徑。 這需要呼叫 WebPermission.WebPermission 時狀態參數設為 Deny。 更好的做法是只允許存取特定資源。

備註

你需要只用資源標準路徑拒絕存取。 不需要使用路徑上所有的語法變化。

備註

使用者名稱與預設埠資訊在比較前會被移除 Uri ，並由建構子提供的 WebPermission(NetworkAccess, Regex) 正規表達式參數進行比較。 若正規表達式包含使用者資訊或預設埠號，則所有輸入 Uri的 s 都無法與正規表達式匹配。

建構函式

名稱	Description
WebPermission()	已淘汰. 建立一個新的類別實例 WebPermission 。
WebPermission(NetworkAccess, Regex)	已淘汰. 初始化該類別的新實例 WebPermission ，並賦予指定存取權限，適用於指定的 URI 正規表達式。
WebPermission(NetworkAccess, String)	已淘汰. 初始化一個擁有指定存取權限的新類別實例 WebPermission 。
WebPermission(PermissionState)	已淘汰. 建立一個新的類別實例 WebPermission ，該類別通過所有需求或失敗。

屬性

名稱	Description
AcceptList	已淘汰. 此屬性回傳由此 WebPermission所持有的單一接受權限的枚舉。 回傳的枚舉中可能包含的物件類型為 String 和 Regex。
ConnectList	已淘汰. 此屬性回傳由 持有 WebPermission的單一連接權限的枚舉。 回傳的枚舉中可能包含的物件類型為 String 和 Regex。

方法

名稱	Description
AddPermission(NetworkAccess, Regex)	已淘汰. 將指定的 URI 及其存取權限加入目前 WebPermission的 。
AddPermission(NetworkAccess, String)	已淘汰. 將指定的 URI 字串及其存取權限加入目前 WebPermission的 。
Assert()	已淘汰. 宣告呼叫程式碼可透過呼叫此方法的程式碼存取受權限要求保護的資源，即使堆疊中較高的呼叫者尚未獲得存取該資源的權限。 使用 Assert() 可能會造成安全問題。 (繼承來源 CodeAccessPermission)
Copy()	已淘汰. 建立一個 WebPermission.
Demand()	已淘汰. 若呼叫堆疊中所有較高的呼叫者尚未獲得當前實例指定的權限，則在執行時強制執行 a SecurityException 。 (繼承來源 CodeAccessPermission)
Deny()	已淘汰. 防止呼叫堆疊中較高的呼叫者使用呼叫此方法的程式碼來存取目前實例指定的資源。 (繼承來源 CodeAccessPermission)
Equals(Object)	已淘汰. 判斷指定的 CodeAccessPermission 物件是否等於當前 CodeAccessPermission的 。 (繼承來源 CodeAccessPermission)
FromXml(SecurityElement)	已淘汰. 從 XML 編碼重建 a WebPermission 。
GetHashCode()	已淘汰. 取得適合用於雜湊演算法及資料結構（如雜湊表）的物件雜湊碼 CodeAccessPermission 。 (繼承來源 CodeAccessPermission)
Intersect(IPermission)	已淘汰. 回傳兩個 WebPermission 實例的邏輯交集。
IsSubsetOf(IPermission)	已淘汰. 判斷電流 WebPermission 是否為指定物件的子集。
IsUnrestricted()	已淘汰. 檢查 的整體權限狀態 WebPermission。
PermitOnly()	已淘汰. 防止呼叫堆疊中較高的呼叫者使用呼叫此方法的程式碼存取除當前實例指定的資源外的所有資源。 (繼承來源 CodeAccessPermission)
ToString()	已淘汰. 建立並回傳當前權限物件的字串表示。 (繼承來源 CodeAccessPermission)
ToXml()	已淘汰. 建立 a WebPermission 及其當前狀態的 XML 編碼。
Union(IPermission)	已淘汰. 回傳兩個類別實例 WebPermission 間的邏輯聯集。

另請參閱

• CodeAccessPermission
• PermissionState
• NetworkAccess