AspNetHostingPermission 類別

定義

命名空間:

System.Web

組件:

System.Security.Permissions.dll

套件:

System.Security.Permissions v9.0.0-preview.5.24306.7

來源:

AspNetHostingPermission.cs

警告

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

控制 ASP.NET 裝載環境中的存取權限。 此類別無法獲得繼承。

public ref class AspNetHostingPermission 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 AspNetHostingPermission : 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 AspNetHostingPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission

Public NotInheritable Class AspNetHostingPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission

繼承

Object

CodeAccessPermission

AspNetHostingPermission

屬性

ObsoleteAttribute

實作

IUnrestrictedPermission

範例

下列程式代碼範例示範使用許可權保護的 AspNetHostingPermission 類別。 程式代碼必須以至少 MinimalAspNetHostingPermission 許可權 Level 執行，才能建立 類別的實例。

using System;
using System.Web;
using System.Security.Permissions;

[AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Medium)]
public class CustomAspNetClass
{
}

Imports System.Web
Imports System.Security.Permissions

<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Medium)> _
Public Class CustomAspNetClass

End Class

備註

警告

代碼啟用安全性 (CAS) 已在所有 .NET Framework 和 .NET 版本中淘汰。 最新版本的 .NET 不接受 CAS 批注，並在使用 CAS 相關 API 時產生錯誤。 開發人員應尋求替代方案來完成安全性工作。

類別 AspNetHostingPermission 會與程式代碼存取安全性搭配使用，以協助保護 System.Web 命名空間中的公用類型。 程式代碼必須至少指派信任層級， Minimal 才能存取受保護的 ASP.NET 類別。

類別 AspNetHostingPermission 的 Level 屬性是藉由在信任組態項目中設定適當的 信任 層級來設定。 根據預設，組 level 態項目的 屬性 trust 會設定為 Full。 也就是說，根據預設，ASP.NET 應用程式會在 Unrestricted 層級下執行。 建立 ASP.NET 應用程式域時，ASP.NET 讀取為level組態專案屬性trust指定的值、使用指定的Level屬性建立 類別的AspNetHostingPermission實例，然後將 類別加入至應用程式域的許可權集合。 如需詳細資訊，請參閱 ASP.NET 信任層級和原則檔案。

建議您針對受信任的月臺， level 將組態項目的 屬性 trust 設定為 High 。 對於不受信任的網站，例如裝載從外部客戶執行程式碼之網站的 Web 伺服器，建議您將組態元素的 trust 屬性設定level為 Medium。

默認為 .NET Framework (定義的許可權集合，例如 LocalIntranet、Internet 等) 不包含 AspNetHostingPermission 許可權。 也就是說， AspNetHostingPermission 預設只會將許可權指派給在信任下 Full 執行的應用程式。

建構函式

AspNetHostingPermission(AspNetHostingPermissionLevel)	已淘汰. 使用指定的使用權限等級，初始化 AspNetHostingPermission 類別的新執行個體。
AspNetHostingPermission(PermissionState)	已淘汰. 使用指定的 AspNetHostingPermission 列舉值，初始化 PermissionState 類別的新執行個體。

屬性

Level

已淘汰. 取得或設定 ASP.NET 應用程式目前裝載的使用權限等級。

方法

Assert()	已淘汰. 宣告即使堆疊中較高層的呼叫端未獲得資源存取權限，呼叫程式碼仍可透過呼叫這個方法的程式碼要求權限，來存取受保護的資源。 使用 Assert() 會造成安全性問題。 (繼承來源 CodeAccessPermission)
Copy()	已淘汰. 由衍生類別實作時，建立並傳回目前權限物件的相同複本。
Demand()	已淘汰. 如果在呼叫堆疊中較高的所有呼叫端都尚未被授與由目前執行個體所指定之權限，則會在執行階段強制執行 SecurityException。 (繼承來源 CodeAccessPermission)
Deny()	已淘汰. 防止呼叫堆疊中較高的呼叫端，使用程式碼呼叫此方法來存取目前執行個體所指定的資源。 (繼承來源 CodeAccessPermission)
Equals(Object)	已淘汰. 判斷指定的 CodeAccessPermission 物件是否等於目前的 CodeAccessPermission。 (繼承來源 CodeAccessPermission)
FromXml(SecurityElement)	已淘汰. 使用 XML 編碼方式重建具有指定狀態的使用權限物件。
GetHashCode()	已淘汰. 取得 CodeAccessPermission 物件的雜湊碼，其適合用於雜湊表這類的雜湊演算法和資料結構。 (繼承來源 CodeAccessPermission)
GetType()	已淘汰. 取得目前執行個體的 Type。 (繼承來源 Object)
Intersect(IPermission)	已淘汰. 當由衍生類別實作時，建立並傳回目前使用權限和指定使用權限交集的使用權限。
IsSubsetOf(IPermission)	已淘汰. 傳回值，指出目前的使用權限是否為指定使用權限的子集。
IsUnrestricted()	已淘汰. 傳回值，指出是否允許不受限制地存取受使用權限保護的資源。
MemberwiseClone()	已淘汰. 建立目前 Object 的淺層複製。 (繼承來源 Object)
PermitOnly()	已淘汰. 防止呼叫堆疊中較高的呼叫端，使用程式碼呼叫此方法來存取目前執行個體所指定之資源以外的所有資源。 (繼承來源 CodeAccessPermission)
ToString()	已淘汰. 建立並傳回目前權限物件的字串表示。 (繼承來源 CodeAccessPermission)
ToXml()	已淘汰. 建立使用權限物件的 XML 編碼方式，和其目前狀態。
Union(IPermission)	已淘汰. 建立目前權限與指定權限聯集的權限。

另請參閱

• AspNetHostingPermissionAttribute
• AspNetHostingPermissionLevel
• 程式碼存取安全性
• 從部分受信任程式碼使用程式庫
• ASP.NET Trust Levels and Policy Files