ObsoleteAttribute 클래스

정의

네임스페이스:

System

어셈블리:

System.Runtime.dll

Source:

ObsoleteAttribute.cs

더 이상 사용되지 않는 프로그램 요소를 표시합니다. 이 클래스는 상속할 수 없습니다.

public ref class ObsoleteAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Delegate | System.AttributeTargets.Enum | System.AttributeTargets.Event | System.AttributeTargets.Field | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Property | System.AttributeTargets.Struct, Inherited=false)]
public sealed class ObsoleteAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Delegate | System.AttributeTargets.Enum | System.AttributeTargets.Event | System.AttributeTargets.Field | System.AttributeTargets.Interface | System.AttributeTargets.Method | System.AttributeTargets.Property | System.AttributeTargets.Struct, Inherited=false)>]
type ObsoleteAttribute = class
    inherit Attribute

Public NotInheritable Class ObsoleteAttribute
Inherits Attribute

상속

Object

Attribute

ObsoleteAttribute

특성

AttributeUsageAttribute

예제

다음 예제에서는 속성과 ObsoleteAttribute 특성으로 표시된 메서드를 포함하는 클래스를 정의합니다. 코드에서 OldProperty 속성 값에 액세스하면 컴파일러 경고가 생성되지만 CallOldMethod 메서드를 호출하면 컴파일러 오류가 발생합니다. 이 예제에서는 소스 코드를 컴파일하려고 할 때 발생하는 출력도 보여 있습니다.

using System;
using System.Reflection;

public class Example
{
   // Mark OldProperty As Obsolete.
   [ObsoleteAttribute("This property is obsolete. Use NewProperty instead.", false)]
   public static string OldProperty
   { get { return "The old property value."; } }

   public static string NewProperty
   { get { return "The new property value."; } }

   // Mark CallOldMethod As Obsolete.
   [ObsoleteAttribute("This method is obsolete. Call CallNewMethod instead.", true)]
   public static string CallOldMethod()
   {
      return "You have called CallOldMethod.";
   }

   public static string CallNewMethod()
   {
      return "You have called CallNewMethod.";
   }

   public static void Main()
   {
      Console.WriteLine(OldProperty);
      Console.WriteLine();
      Console.WriteLine(CallOldMethod());
   }
}
// The attempt to compile this example produces output like the following output:
//    Example.cs(31,25): error CS0619: 'Example.CallOldMethod()' is obsolete:
//            'This method is obsolete. Call CallNewMethod instead.'
//    Example.cs(29,25): warning CS0618: 'Example.OldProperty' is obsolete:
//            'This property is obsolete. Use NewProperty instead.'

open System

// Mark oldValue As Obsolete.
[<ObsoleteAttribute("This value is obsolete. Use newValue instead.", false)>]
let oldValue =
    "The old property value."

let newValue =
    "The new property value."

// Mark callOldFunction As Obsolete.
[<ObsoleteAttribute("This function is obsolete. Call callNewFunction instead.", true)>]
let callOldFunction () =
    "You have called CallOldMethod."

let callNewFunction () =
    "You have called CallNewMethod."

printfn $"{oldValue}"
printfn ""
printfn $"{callOldFunction ()}"
// The attempt to compile this example produces output like the following output:
//    Example.fs(23,12): error FS0101: This construct is deprecated. This function is obsolete. Call callNewFunction instead.
//    Example.fs(21,12): warning FS0044: This construct is deprecated. This value is obsolete. Use newValue instead.

Imports System.Reflection

Public Module Example
   ' Mark OldProperty As Obsolete.
   <ObsoleteAttribute("This property is obsolete. Use NewProperty instead.", False)> 
   Public ReadOnly Property OldProperty As String
      Get
         Return "The old property value."
      End Get
   End Property
   
   Public ReadOnly Property NewProperty As String
      Get
         Return "The new property value."
      End Get
   End Property
   
   ' Mark OldMethod As Obsolete.
   <ObsoleteAttribute("This method is obsolete. Call CallNewMethod instead.", True)> 
   Public Function CallOldMethod() As String
      Return "You have called CallOldMethod."
   End Function
      
   Public Function CallNewMethod() As String   
      Return "You have called NewMethod."
   End Function   
   
   Public Sub Main()
      Console.WriteLine(OldProperty)
      Console.WriteLine()
      Console.WriteLine(CallOldMethod())
   End Sub  
End Module
'  The attempt to compile this example produces output like the following:
'    Example.vb(30) : warning BC40000: 'Public ReadOnly Property OldProperty As String' is obsolete: 
'                     'This property is obsolete. Use NewProperty instead.'.
'    
'          Console.WriteLine(OldProperty)
'                            ~~~~~~~~~~~
'    Example.vb(32) : error BC30668: 'Public Function CallOldMethod() As String' is obsolete: 
'                     'This method is obsolete. Call CallNewMethod instead.'.
'    
'          Console.WriteLine(CallOldMethod())
'                            ~~~~~~~~~~~~~

설명

ObsoleteAttribute 어셈블리, 모듈, 매개 변수 및 반환 값을 제외한 모든 프로그램 요소에 적용할 수 있습니다. 요소를 사용되지 않는 것으로 표시하면 이후 버전의 제품에서 요소가 제거될 수 있음을 사용자에게 알릴 수 있습니다.

Message 속성에 할당된 문자열은 코드에서 특성 대상이 사용될 때 컴파일러에서 내보냅니다. 이상적으로 문자열은 몇 가지 해결 방법 또는 프로그래밍 방식의 대안을 제공해야 합니다.

IsError 속성을 사용하여 ObsoleteAttribute 특성을 사용하여 오류를 발생시킬지(IsErrortrue) 또는 경고(IsErrorfalse)를 내보내야 하는지 여부를 컴파일러에 표시합니다.

특성을 사용하는 방법에 대한 자세한 내용은 특성참조하세요.

생성자

ObsoleteAttribute()	기본 속성을 사용하여 ObsoleteAttribute 클래스의 새 인스턴스를 초기화합니다.
ObsoleteAttribute(String, Boolean)	해결 방법 메시지와 사용되지 않는 요소 사용이 오류로 간주되는지 여부를 나타내는 부울 값을 사용하여 ObsoleteAttribute 클래스의 새 인스턴스를 초기화합니다.
ObsoleteAttribute(String)	지정된 해결 방법을 사용하여 ObsoleteAttribute 클래스의 새 인스턴스를 초기화합니다.

속성

DiagnosticId	API 사용을 보고할 때 컴파일러가 사용할 ID를 가져오거나 설정합니다.
IsError	컴파일러가 사용되지 않는 프로그램 요소의 사용을 오류로 처리할지 여부를 나타내는 값을 가져옵니다.
Message	해결 방법 메시지를 가져옵니다.
TypeId	파생 클래스에서 구현되는 경우 이 Attribute대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)
UrlFormat	해당 설명서의 URL을 가져오거나 설정합니다. API는 실제 URL 대신 형식 문자열을 허용하여 진단 ID를 포함하는 제네릭 URL을 만듭니다.

메서드

Equals(Object)	이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의되는 경우 이 인스턴스의 값이 파생 클래스의 기본값인지 여부를 나타냅니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의되는 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)

추가 정보

• Attribute
• 특성 사용하여 메타데이터 확장