WebPermissionAttribute 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
警告
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)]
[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)]
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}")>]
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
[<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
Public NotInheritable Class WebPermissionAttribute
Inherits CodeAccessSecurityAttribute
- 繼承
- 屬性
範例
下列範例示範如何套用 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) |