AspNetHostingPermission 類別

  • 參考

定義

命名空間:
System.Web
組件:
System.Security.Permissions.dll
組件:
System.dll

警告

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
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}")]
public sealed class AspNetHostingPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission
[System.Serializable]
public sealed class AspNetHostingPermission : System.Security.CodeAccessPermission, System.Security.Permissions.IUnrestrictedPermission
type AspNetHostingPermission = class
    inherit CodeAccessPermission
    interface 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
[<System.Serializable>]
type AspNetHostingPermission = class
    inherit CodeAccessPermission
    interface IUnrestrictedPermission
Public NotInheritable Class AspNetHostingPermission
Inherits CodeAccessPermission
Implements IUnrestrictedPermission
繼承
Object
CodeAccessPermission
AspNetHostingPermission
屬性
ObsoleteAttribute SerializableAttribute
實作
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 中已被取代。 使用 CAS 相關 API 時，最新版本的 .NET 不會接受 CAS 批註，並產生錯誤。 開發人員應該尋求替代方式來完成安全性工作。

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

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

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

預設為.NET Framework (定義的許可權集合，例如 LocalIntranet、網際網路等) 不包含 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)
已淘汰.

建立目前權限與指定權限聯集的權限。

適用於

另請參閱