using System;

class Sample {
  // UrlFormatに指定する共通のURL
  const string obsoleteUrlFormat = "https://example.com/api/doc-{0}.html";

  // Obsolete属性にDiagnosticId, UrlFormatを割り当てる
  [Obsolete("このメソッドは非推奨です", DiagnosticId = "WARN_FOO", UrlFormat = obsoleteUrlFormat)]
  static void Foo() {}

  [Obsolete("このメソッドは廃止されました", error: true, DiagnosticId = "ERROR_BAR", UrlFormat = obsoleteUrlFormat)]
  static void Bar() {}

  static void Main()
  {
    Foo(); // warning WARN_FOO: 'Sample.Foo()' は旧形式です ('このメソッドは非推奨です')
    Bar(); // error ERROR_BAR: 'Sample.Bar()' は旧形式です ('このメソッドは廃止されました')
  }
}

Imports System

Class Sample
  ' UrlFormatに指定する共通のURL
  Const obsoleteUrlFormat As String = "https://example.com/api/doc-{0}.html"

  ' Obsolete属性にDiagnosticId, UrlFormatを割り当てる
  <Obsolete("このメソッドは非推奨です", DiagnosticId := "WARN_FOO", UrlFormat := obsoleteUrlFormat)> _
  Shared Sub Foo()
  End Sub

  <Obsolete("このメソッドは廃止されました", True, DiagnosticId := "WARN_BAR", UrlFormat := obsoleteUrlFormat)> _
  Shared Sub Bar()
  End Sub

  Shared Sub Main()
    Foo() ' warning WARN_FOO: 'Public Shared Sub Foo()' は廃止されています: 'このメソッドは非推奨です'。
    Bar() ' error WARN_BAR: 'Public Shared Sub Bar()' は廃止されています: 'このメソッドは廃止されました'。
  End Sub
End Class

using System;
using System.IO;
using System.Linq;

using Microsoft.CodeAnalysis;
using Microsoft.CodeAnalysis.CSharp; // `dotnet add sample.csproj package Microsoft.CodeAnalysis.CSharp`

const string sourceFile = "test.cs";

var tree = CSharpSyntaxTree.ParseText(
  text: File.ReadAllText(sourceFile),
  options: new CSharpParseOptions(
    languageVersion: LanguageVersion.Default,
    documentationMode: DocumentationMode.Parse,
    kind: SourceCodeKind.Regular
  )
);
var compilation = CSharpCompilation
  .Create(assemblyName: "test")
  .AddReferences(MetadataReference.CreateFromFile(typeof(string).Assembly.Location))
  .WithOptions(
    new CSharpCompilationOptions(
      outputKind: OutputKind.ConsoleApplication
    )
  )
  .AddSyntaxTrees(tree);

foreach (var d in compilation
  .GetDiagnostics()
  .Where(d => d.Severity == DiagnosticSeverity.Warning || d.Severity == DiagnosticSeverity.Error)
) {
  Console.WriteLine("{0}, see {1}", d, d.Descriptor.HelpLinkUri);
}

(16,5): warning WARN_FOO: 'Sample.Foo()' は旧形式です ('このメソッドは非推奨です'), see https://example.com/api/doc-WARN_FOO.html
(17,5): error ERROR_BAR: 'Sample.Bar()' は旧形式です ('このメソッドは廃止されました'), see https://example.com/api/doc-ERROR_BAR.html

Option Infer On

Imports System
Imports System.IO
Imports System.Linq

Imports Microsoft.CodeAnalysis
Imports Microsoft.CodeAnalysis.VisualBasic ' `dotnet add sample.vbproj package Microsoft.CodeAnalysis.VisualBasic`

Class Sample
  Shared Sub Main()
    Const sourceFile As String = "test.vb"

    Dim tree = VisualBasicSyntaxTree.ParseText(
      text := File.ReadAllText(sourceFile),
      options := New VisualBasicParseOptions(
        languageVersion := LanguageVersion.Default,
        documentationMode := DocumentationMode.Parse,
        kind := SourceCodeKind.Regular
      )
    )
    Dim compilation = VisualBasicCompilation.
      Create(assemblyName := "test").
      AddReferences(MetadataReference.CreateFromFile(GetType(String).Assembly.Location)).
      WithOptions(
        New VisualBasicCompilationOptions(
          outputKind := OutputKind.ConsoleApplication
        )
      ).
      AddSyntaxTrees(tree)

    For Each d In compilation.
      GetDiagnostics().
      Where(Function (_d) _d.Severity = DiagnosticSeverity.Warning OrElse _d.Severity = DiagnosticSeverity.Error)

      Console.WriteLine("{0}, see {1}", d, d.Descriptor.HelpLinkUri)
    Next
  End Sub
End Class

(17,5): warning WARN_FOO: 'Public Shared Sub Foo()' は廃止されています: 'このメソッドは非推奨です'。, see https://example.com/api/doc-WARN_FOO.html
(18,5): error WARN_BAR: 'Public Shared Sub Bar()' は廃止されています: 'このメソッドは廃止されました'。, see https://example.com/api/doc-WARN_BAR.html

using System;

// アセンブリ全体には適用できない
//[assembly: Obsolete]

namespace ClassLibrary {
  [Obsolete] public struct S { }
  [Obsolete] public interface I {}

  [Obsolete] public class C {
    [Obsolete] void Method() {}

    [Obsolete] bool Property {
      [Obsolete] get;
      [Obsolete] set;
    }

    [Obsolete] event EventHandler Event;
    [Obsolete] int Field;
  }
}

Imports System

' アセンブリ全体には適用できない
'<Assembly: Obsolete>

Namespace ClassLibrary
  <Obsolete> _
  Public Structure S
  End Structure

  <Obsolete> _
  Public Interface I
  End Interface

  <Obsolete> _
  Public Class C
    <Obsolete> _
    Sub Method()
    End Sub

    <Obsolete> _
    Property P As Boolean
      <Obsolete> _
      Get
        Return False
      End Get
      <Obsolete> _
      Set
      End Set
    End Property

    <Obsolete> _
    Event E As EventHandler

    <Obsolete> _
    Dim Filed As Integer
  End Class
End Namespace

using System;
using System.Reflection;

class Sample {
  [Obsolete("呼び出しがエラーとなるメソッド", error: true)]
  public static void M()
  {
    Console.WriteLine("このメソッドの呼び出しはコンパイルエラーになりますが、リフレクションによる呼び出しは成功します。");
  }

  static void Main()
  {
    // リフレクションによって上記のObsoleteなメソッドを呼び出す
    // (コンパイルエラーにならず、例外もスローせずに呼び出せてしまう)
    typeof(Sample).InvokeMember("M", BindingFlags.InvokeMethod, null, null, null);
  }
}

Imports System
Imports System.Reflection

Class Sample
  <Obsolete("呼び出しがエラーとなるメソッド", True)> _
  Public Shared Sub M()
    Console.WriteLine("このメソッドの呼び出しはコンパイルエラーになりますが、リフレクションによる呼び出しは成功します。")
  End Sub

  Shared Sub Main()
    ' リフレクションによって上記のObsoleteなメソッドを呼び出す
    ' (コンパイルエラーにならず、例外もスローせずに呼び出せてしまう)
    GetType(Sample).InvokeMember("M", BindingFlags.InvokeMethod, Nothing, Nothing, Nothing)
  End Sub
End Class