CS2001～

C# コンパイラエラー CS4009 について解説

2025-03-29更新日: 2025-03-29

CS4009 は C# のコンパイラエラーです。

エントリーポイントである Mainメソッドに async 修飾子を使用すると、C# 7.0 以下ではエラーになります。

解決するには C# のバージョンを 7.1 以降に更新するか、Main から async と await を削除してください。

非同期処理の完了待機にも注意が必要です。

目次から探す

エラー発生の背景
- CS4009 エラーの概要
- async 修飾子と Main メソッドの関係
C# の言語バージョンと非同期処理の変遷
- C# 7.0 以下における制約
- C# 7.1 以降の変更点
エラー発生例と修正方法
- async 修飾子を使用したコード例
- バージョンアップによる解決策
非同期処理実行時の注意事項
- await キーワード使用時の留意点
- 非同期メソッド完了待機の対策
まとめ

エラー発生の背景

CS4009 エラーの概要

CS4009 エラーは、エントリポイントである Mainメソッドに async 修飾子を付けた場合に発生するエラーです。

具体的には、C# の古い言語バージョン(7.0 以下)で、Mainメソッドに async を指定するとコンパイラがエラーを返します。

エラーメッセージは以下のようになります。

'Type.Method': エントリ ポイントに async 修飾子を指定することはできません。

このエラーは、エントリポイントのシグネチャが非同期処理に対応していないことが原因です。

C# 7.1 以降では、async を使用したエントリポイントがサポートされるため、この問題は解決可能です。

async 修飾子と Main メソッドの関係

Mainメソッドはプログラムの起動時に最初に呼び出されるメソッドです。

C# 7.0 以下では、Mainメソッドは同期処理として実装する必要があり、async を指定するとエラーが発生します。

一方、C# 7.1 以降では、async Task Main() または async Task<int> Main() の形式でエントリポイントを実装できるようになりました。

これにより、エントリポイントからそのまま非同期処理を実行できるため、コードの見通しがよくなります。

C# の言語バージョンと非同期処理の変遷

C# 7.0 以下における制約

C# 7.0 以下のバージョンでは、Mainメソッドは同期的な処理として定義する必要があり、非同期処理を直接開始することができません。

そのため、非同期メソッドを実行したい場合には、Task.Wait() や Task.Result を利用して結果を待機する必要があります。

これにより、プログラムの処理がブロックされる可能性があり、非同期処理の利点が十分に活かせない場合があります。

C# 7.1 以降の変更点

C# 7.1 以降では、言語仕様が拡張され、Mainメソッドに async 修飾子を付けることが可能となりました。

この変更により、非同期メソッドを直接呼び出して実行できるようになり、コードのシンプルさと可読性が向上します。

非同期 Main メソッドの採用方法

C# 7.1 以降では、エントリポイントとなる Mainメソッドを非同期メソッドとして定義できます。

具体的には、以下のような形式が採用可能です。

using System;
using System.Threading.Tasks;
public class Program
{
    public static async Task Main()
    {
        Console.WriteLine("2秒間待機を開始します");
        await WaitTwoSeconds();
        Console.WriteLine("プログラムを終了します");
    }
    // 非同期メソッドのサンプル
    private static async Task WaitTwoSeconds()
    {
        await Task.Delay(2000); // 2秒間待機する処理
        Console.WriteLine("非同期処理から戻りました");
    }
}

2秒間待機を開始します
非同期処理から戻りました
プログラムを終了します

このように、async Task Main() を使用することで、直接 await キーワードを利用して非同期処理が可能になります。

戻り値および待機方法の違い

C# 7.0 以下では、エントリポイントが非同期に対応していないため、非同期メソッドの呼び出し後に Task.Wait() や Task.Result を用いて結果を待つ必要がありました。

例えば、以下のようなコードが用いられていました。

using System;
using System.Threading.Tasks;
public class Program
{
    public static void Main()
    {
        Console.WriteLine("2秒間待機を開始します");
        // 非同期メソッドの完了を強制的に待機する方法
        WaitTwoSeconds().Wait();
        Console.WriteLine("プログラムを終了します");
    }
    private static async Task WaitTwoSeconds()
    {
        await Task.Delay(2000);
        Console.WriteLine("非同期処理から戻りました");
    }
}

2秒間待機を開始します
非同期処理から戻りました
プログラムを終了します

この方法では、非同期処理のスムーズな実行が阻害される可能性があるため、C# 7.1 以降の非同期 Mainメソッドが推奨されています。

エラー発生例と修正方法

async 修飾子を使用したコード例

エラー発生の理由紹介

次の例は、C# 7.0 以下の環境で Mainメソッドに async 修飾子を付けた場合のコードです。

このコードを実行すると、CS4009 エラーが発生します。

using System;
using System.Threading.Tasks;
public class Example
{
    // C# 7.0 以下ではエントリポイントに async を指定できないためエラーとなる
    public static async void Main()
    {
        Console.WriteLine("2秒間待機を開始します");
        await WaitTwoSeconds();
        Console.WriteLine("プログラムを終了します");
    }
    private static async Task WaitTwoSeconds()
    {
        await Task.Delay(2000); // 2秒間待機
        Console.WriteLine("非同期メソッドから戻りました");
    }
}

コンパイラ エラー: 'Example.Main': エントリ ポイントに async 修飾子を指定することはできません。

このサンプルでは、async 修飾子がエントリポイントである Mainメソッドに指定されているため、コンパイラがエラーを返します。

バージョンアップによる解決策

コード修正例のポイント

C# の言語バージョンを 7.1 以降に更新することで、エラーを解消することが可能です。

以下のサンプルコードは、C# 7.1 以降に対応した async Task Main() の形式を示しています。

これにより、エントリポイントで直接非同期処理が実行できるようになります。

using System;
using System.Threading.Tasks;
public class Example
{
    // C# 7.1 以降ではエントリポイントに async Task を指定可能
    public static async Task Main()
    {
        Console.WriteLine("2秒間待機を開始します");
        await WaitTwoSeconds();
        Console.WriteLine("プログラムを終了します");
    }
    private static async Task WaitTwoSeconds()
    {
        await Task.Delay(2000); // 2秒間待機
        Console.WriteLine("非同期メソッドから戻りました");
    }
}

2秒間待機を開始します
非同期メソッドから戻りました
プログラムを終了します

この変更により、古いバージョンで発生していた CS4009 エラーが解消され、自然な非同期処理が実現できます。

非同期処理実行時の注意事項

await キーワード使用時の留意点

非同期メソッドを実行する際に await キーワードを使用すると、非同期処理が完了するまでその待機ポイントで処理が一時停止され、後続の処理が実行されます。

これにより、UI スレッドなどがブロックされるのを防ぐ効果があります。

ただし、以下の点に注意が必要です。

await を使用するためには、呼び出し元のメソッドにも async 修飾子が必要です。
非同期処理を正しく待機せずに次の処理へ進むと、CS4014 警告が発生する場合があります。

Task.Wait() と Task.Result の使い分け

C# 7.0 以下では、Task.Wait() や Task.Result を使用して非同期メソッドの完了を待つ方法が用いられていました。

これらの違いは以下の通りです。

Task.Wait(): 非同期処理の完了まで同期的に待機します。戻り値を必要としない場合に利用します。
Task.Result: 非同期処理の結果を同期的に取得しますが、例外が発生した場合に AggregateException としてラップされる可能性があるため、取り扱いに注意が必要です。

これらの方法を使用すると、非同期処理の本来のメリットが失われることがあるため、可能な場合は C# 7.1 以降の async Task Main() を利用するのが望ましいです。

非同期メソッド完了待機の対策

コンパイラ警告との対処方法

非同期メソッドを呼び出した後に結果の待機を怠ると、コンパイラから CS4014 警告が発生します。

警告が表示されると、非同期メソッドが完了する前にプログラムが終了してしまう可能性があります。

この対策としては、以下の方法があります。

エントリポイントで async Task Main() を採用し、await キーワードを利用して非同期処理を待機する。
C# 7.0 以下の環境では、非同期メソッドの戻り値に対して Wait() や Result を使用し、確実に処理が完了するまで待機する。

たとえば、C# 7.0 以下の環境での対応例は以下の通りです。

using System;
using System.Threading.Tasks;
public class Example
{
    public static void Main()
    {
        Console.WriteLine("2秒間待機を開始します");
        // 非同期処理が完了するまで待機するために Wait() を使用
        WaitTwoSeconds().Wait();
        Console.WriteLine("プログラムを終了します");
    }
    private static async Task WaitTwoSeconds()
    {
        await Task.Delay(2000);
        Console.WriteLine("非同期処理から戻りました");
    }
}

2秒間待機を開始します
非同期処理から戻りました
プログラムを終了します

このように、適切に非同期メソッドの終了を待つことで、CS4014 警告を回避し、プログラムの予期せぬ終了を防止できます。

まとめ

この記事では、C#で発生するコンパイラエラーCS4009の原因と、その対応方法について解説しています。

C# 7.0以前ではMainメソッドにasync修飾子を使用できず、エラーが発生する理由を説明し、C# 7.1以降の非同期エントリポイント対応について、具体例を交えて紹介しています。

また、非同期処理実行時のawaitの使い方や、Task.Wait()とTask.Resultの違い、コンパイラ警告への対処法についても説明しています。