DnsPermissionAttribute 類別

定義

命名空間:

System.Net

組件:

System.Security.Permissions.dll

套件:

System.Security.Permissions v9.0.0-rc.2.24473.5

來源:

DnsPermissionAttribute.cs

警告

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

指定要求網域名稱伺服器 (Domain Name Server) 中資訊的使用權限。

public ref class DnsPermissionAttribute 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 DnsPermissionAttribute : 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 DnsPermissionAttribute = class
    inherit CodeAccessSecurityAttribute

Public NotInheritable Class DnsPermissionAttribute
Inherits CodeAccessSecurityAttribute

繼承

Object

Attribute

SecurityAttribute

CodeAccessSecurityAttribute

DnsPermissionAttribute

屬性

AttributeUsageAttribute ObsoleteAttribute

範例

下列範例會使用 DnsPermissionAttribute 將宣告式安全性套用至自定義類別。

//Uses the DnsPermissionAttribute to restrict access only to those who have permission.

[DnsPermission(SecurityAction::Demand,Unrestricted=true)]
public ref class MyClass
{
public:
   static IPAddress^ GetIPAddress()
   {
      IPAddress^ ipAddress = Dns::Resolve( "localhost" )->AddressList[ 0 ];
      return ipAddress;
   }

};

int main()
{
   try
   {
      
      //Grants Access.
      Console::WriteLine( " Access granted\n The local host IP Address is :{0}", MyClass::GetIPAddress() );
   }
   // Denies Access.
   catch ( SecurityException^ securityException ) 
   {
      Console::WriteLine( "Access denied" );
      Console::WriteLine( securityException->ToString() );
   }

}

public class MyClass
{
    public static IPAddress GetIPAddress()
    {
        IPAddress ipAddress = Dns.Resolve("localhost").AddressList[0];
        return ipAddress;
    }
    public static void Main()
    {
        try
        {
            //Grants Access.
            Console.WriteLine(" Access granted\n The local host IP Address is :" +
                                  MyClass.GetIPAddress().ToString());
        }
        // Denies Access.
        catch (SecurityException securityException)
        {
            Console.WriteLine("Access denied");	
            Console.WriteLine(securityException.ToString());
        }
    }
}

' Uses the DnsPermissionAttribute to restrict access only to those who have permission.
<DnsPermission(SecurityAction.Demand, Unrestricted := true)>  _
Public Class MyClass1
   
   Public Shared Function GetIPAddress() As IPAddress
      Dim ipAddress As IPAddress = Dns.Resolve("localhost").AddressList(0)
      Return ipAddress
   End Function 'GetIPAddress
   
   Public Shared Sub Main()
      Try
         ' Grants Access.
         Console.WriteLine(("Access granted" + ControlChars.NewLine + " The local host IP Address is :" + MyClass1.GetIPAddress().ToString()))
      ' Denies Access.
      Catch securityException As SecurityException
         Console.WriteLine("Access denied")
         Console.WriteLine(securityException.ToString())
      End Try
   End Sub
End Class

備註

警告

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

所 DnsPermissionAttribute 宣告的安全性資訊會儲存在屬性目標的元數據中，這是套用的類別 DnsPermissionAttribute 。 系統接著會在運行時間存取這項資訊。 SecurityAction傳遞至建構函式的 會決定允許的 DNS 目標。

這些安全性屬性僅用於 宣告式安全性。 針對 命令式安全性，請使用對應的 DnsPermission 類別。

安全性存取受到完全限制或完全不受限制。 將 Unrestricted 屬性設定為 true 以授與存取權，或 false 不授與存取權。 將此屬性設定為具名參數。

如需使用屬性的詳細資訊，請參閱 屬性。

建構函式

DnsPermissionAttribute(SecurityAction)

已淘汰. 使用指定的 SecurityAction 值，初始化 DnsPermissionAttribute 類別的新執行個體。

屬性

Action	已淘汰. 取得或設定安全性動作。 (繼承來源 SecurityAttribute)
TypeId	已淘汰. 在衍生類別中實作時，取得這個 Attribute 的唯一識別碼。 (繼承來源 Attribute)
Unrestricted	已淘汰. 取得或設定數值，表示是否宣告由屬性所保護之資源的完整 (不受限制的) 使用權限。 (繼承來源 SecurityAttribute)

方法

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

另請參閱

• CodeAccessSecurityAttribute