WebPermissionAttribute 類別

定義

命名空間:

System.Net

組件:

System.Security.Permissions.dll

組件:

System.dll

警告

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

指定存取網際網路資源的使用權限。 此類別無法獲得繼承。

public ref class WebPermissionAttribute sealed : System::Security::Permissions::CodeAccessSecurityAttribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
public sealed class WebPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
[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 WebPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
[System.Serializable]
public sealed class WebPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)>]
type WebPermissionAttribute = class
    inherit CodeAccessSecurityAttribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)>]
[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type WebPermissionAttribute = class
    inherit CodeAccessSecurityAttribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)>]
[<System.Serializable>]
type WebPermissionAttribute = class
    inherit CodeAccessSecurityAttribute

Public NotInheritable Class WebPermissionAttribute
Inherits CodeAccessSecurityAttribute

繼承

Object

Attribute

SecurityAttribute

CodeAccessSecurityAttribute

WebPermissionAttribute

屬性

AttributeUsageAttribute ObsoleteAttribute SerializableAttribute

範例

下列範例示範如何套用 WebPermissionAttribute 至方法。

public:
   // Deny access to a specific resource by setting the ConnectPattern property.
   [method:WebPermission(SecurityAction::Deny,ConnectPattern="http://www.contoso.com/")]

   void Connect()
   {
      // Create a Connection.
      HttpWebRequest^ myWebRequest = (HttpWebRequest^)(WebRequest::Create( "http://www.contoso.com" ));
      Console::WriteLine( "This line should never be printed" );
   }

    // Deny access to a specific resource by setting the ConnectPattern property. 
   [WebPermission(SecurityAction.Deny, ConnectPattern=@"http://www\.contoso\.com/")]

public void Connect() 
     {
        // Create a Connection.  
        HttpWebRequest myWebRequest = (HttpWebRequest)WebRequest.Create("http://www.contoso.com");
        Console.WriteLine("This line should never be printed");
     }

' Deny access to a specific resource by setting the ConnectPattern property. 
<WebPermission(SecurityAction.Deny, ConnectPattern := "http://www\.contoso\.com/.*")> Public Sub Connect()

' Create a Connection.	 
Dim myWebRequest As HttpWebRequest = CType(WebRequest.Create("http://www.contoso.com"), HttpWebRequest)
Console.WriteLine("This line should never be printed")

備註

警告

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

WebPermissionAttribute 可讓您以宣告方式指定類別可以使用的 URI 字串和正則運算式字串。

中指定的 WebPermissionAttribute 安全性資訊會儲存在屬性目標的中繼資料中，這是套用的目標 WebPermissionAttribute 類別。 系統會在執行時間存取這項資訊。 System.Security.Permissions.SecurityAction傳遞至建構函式的 會決定允許 WebPermissionAttribute 的目標。 系統會使用 WebPermission 方法傳回的 CreatePermission ，將屬性目標的安全性資訊轉換為中繼資料中儲存的可序列化表單。

注意

WebPermissionAttribute 僅用於 宣告式安全性。 針對 命令式安全性，請使用對應的 WebPermission 。

建構函式

WebPermissionAttribute(SecurityAction)

已淘汰. 以指定可以在這個類別上執行的安全性動作的值，初始化 WebPermissionAttribute 類別的新執行個體。

屬性

Accept	已淘汰. 取得或設定目前 WebPermissionAttribute 可接受的 URI 字串。
AcceptPattern	已淘汰. 取得或設定目前 WebPermissionAttribute 可接受的 URI 其規則運算式模式描述。
Action	已淘汰. 取得或設定安全性動作。 (繼承來源 SecurityAttribute)
Connect	已淘汰. 取得或設定目前 WebPermissionAttribute 所使用的 URI 連接字串。
ConnectPattern	已淘汰. 取得或設定由目前 WebPermissionAttribute 控制的 URI 連接其規則運算式模式描述。
TypeId	已淘汰. 在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)
Unrestricted	已淘汰. 取得或設定數值，表示是否宣告由屬性所保護之資源的完整 (不受限制的) 使用權限。 (繼承來源 SecurityAttribute)

方法

CreatePermission()	已淘汰. 建立並傳回 WebPermission 類別的新執行個體。
Equals(Object)	已淘汰. 傳回值，這個值指出此執行個體是否與指定的物件相等。 (繼承來源 Attribute)
GetHashCode()	已淘汰. 傳回這個執行個體的雜湊碼。 (繼承來源 Attribute)
GetType()	已淘汰. 取得目前執行個體的 Type。 (繼承來源 Object)
IsDefaultAttribute()	已淘汰. 在衍生類別中覆寫時，表示這個執行個體的值是衍生類別的預設值。 (繼承來源 Attribute)
Match(Object)	已淘汰. 在衍生類別中覆寫時，會傳回值，表示這個執行個體是否等於指定物件。 (繼承來源 Attribute)
MemberwiseClone()	已淘汰. 建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	已淘汰. 傳回代表目前物件的字串。 (繼承來源 Object)

明確介面實作

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	已淘汰. 將一組名稱對應至一組對應的分派識別項 (Dispatch Identifier)。 (繼承來源 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)	已淘汰. 擷取物件的類型資訊，可以用來取得介面的類型資訊。 (繼承來源 Attribute)
_Attribute.GetTypeInfoCount(UInt32)	已淘汰. 擷取物件提供的類型資訊介面數目 (0 或 1)。 (繼承來源 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	已淘汰. 提供物件所公開的屬性和方法的存取權。 (繼承來源 Attribute)