Main() とコマンド ライン引数

ランタイムは、C# アプリケーションの起動時に メソッドを呼び出します。 メソッドは、C# アプリケーションのエントリ ポイントです

C# プログラムはエントリ ポイントを 1 つだけ持つことができます。 メソッドを持つ複数のクラスがある場合は、プログラムをコンパイルするときに StartupObject コンパイラ オプションを使用して、エントリ ポイントとして機能する メソッドを指定する必要があります。 詳細については、「StartupObject (C# コンパイラ オプション)」を参照してください。 次の例では、最初のアクションとしてコマンド ライン引数の数を表示します。

class TestClass
{
    static void Main(string[] args)
    {
        Console.WriteLine(args.Length);
    }
}

アプリケーションのエントリ ポイントとして、1 つのファイルで最上位レベルのステートメントを使用することもできます。 メソッドと同様に、最上位レベルのステートメントは値を返し、コマンドライン引数にアクセスできます。 詳しくは、「最上位レベルのステートメント」を参照してください。 次の例では、 ループを使用して、 変数を使用してコマンド ライン引数を表示し、プログラムの最後に成功コード () を返します。

using System.Text;

StringBuilder builder = new();
builder.AppendLine("The following arguments are passed:");

foreach (var arg in args)
{
    builder.AppendLine($"Argument={arg}");
}

Console.WriteLine(builder.ToString());

return 0;

C# 14 以降では、1 つのファイルにプログラムが含まれるファイル ベースのアプリをプログラムにすることができます。 ファイル ベースのアプリは、コマンド を使用するか、最初の行として ディレクティブを使用して実行します (Unix シェルのみ)。

概要

• メソッドは、実行可能プログラムのエントリ ポイントです。 ここで、プログラム コントロールの開始と終了が行われます。
• クラスまたは構造体内で を宣言する必要があります。 外側の は でもかまいません。
• は、 である必要があります。
• は、任意の アクセス修飾子を持つことができます。
• は、 、 、 、または を返すことができます。
• がまたはを返す場合にのみ、の宣言に修飾子を含めることができます。 この規則では、 メソッドは特に除外されます。
• メソッドは、コマンド ライン引数を含む パラメーターを使用して、または指定せずに宣言できます。 Visual Studioを使用してWindows アプリケーションを作成する場合は、パラメーターを手動で追加するか、GetCommandLineArgs() メソッドを使用してコマンド ライン引数を取得できます。 パラメーターは、インデックスが 0 のコマンド ライン引数です。 C および C++ とは異なり、プログラムの名前は 配列の最初のコマンド ライン引数として扱われませんが、 メソッドの最初の要素です。

次の一覧は、最も一般的な 宣言を示したものです。

static void Main() { }
static int Main() { }
static void Main(string[] args) { }
static int Main(string[] args) { }
static async Task Main() { }
static async Task<int> Main() { }
static async Task Main(string[] args) { }
static async Task<int> Main(string[] args) { }

上記の例ではアクセス修飾子を指定していないため、既定で暗黙的に に設定されます。 明示的なアクセス修飾子を指定できます。

Main() の戻り値

次のいずれかの方法でメソッドを定義することで、 メソッドから を返すことができます。

からの戻り値が使用されていない場合は、またはを返すと、コードが少し単純になります。

ただし、 か を返すことによって、プログラムが状態の情報を、実行可能ファイルを呼び出す他のプログラムまたはスクリプトに伝達することができます。

次の例からは、プロセスの終了コードにアクセスする方法がわかります。

この例では、.NET Core コマンドライン ツールを使用します。 .NET Core コマンド ライン ツールに慣れていない場合は、このget-started 記事で学習できます。

を実行して新しいアプリケーションを作成します。 メソッドをProgram.csで次のように変更します。

class MainReturnValTest
{
    static int Main()
    {
        //...
        return 0;
    }
}

このプログラムを MainReturnValTest.csとして保存することを忘れないでください。

Windowsでプログラムを実行すると、Main 関数から返された値が環境変数に格納されます。 この環境変数は、バッチ ファイルから を使用するか、PowerShell から して取得できます。

dotnet CLI コマンドを使用して、アプリケーションをビルドできます。

次に、アプリケーションを実行して結果を表示する PowerShell スクリプトを作成します。 次のコードをテキスト ファイルに貼り付け、プロジェクトが保存されているフォルダーに として保存します。 PowerShell プロンプトに「」と入力して PowerShell スクリプトを実行します。

コードから 0 が返されるため、バッチ ファイルは成功を報告します。 ただし、MainReturnValTest.csを変更して 0 以外の値を返し、プログラムを再コンパイルすると、PowerShell スクリプトの後続の実行でエラーが報告されます。

dotnet run
if ($LastExitCode -eq 0) {
    Write-Host "Execution succeeded"
} else
{
    Write-Host "Execution Failed"
}
Write-Host "Return value = " $LastExitCode

Execution succeeded
Return value = 0

非同期 Main の戻り値

の戻り値を宣言すると、コンパイラは、で非同期メソッドを呼び出すための定型コードを生成します。

class Program
{
    static async Task<int> Main(string[] args)
    {
        return await AsyncConsoleWork();
    }

    private static async Task<int> AsyncConsoleWork()
    {
        return 0;
    }
}

どちらの例でも、プログラムの本体は メソッドの本体内にあります。

を として宣言することには、コンパイラによって常に正しいコードが生成されるという利点があります。

アプリケーションのエントリ ポイントから または が返されると、コンパイラによって、アプリケーション コードで宣言されたエントリ ポイント メソッドを呼び出す新しいエントリ ポイントが生成されます。 このエントリ ポイント名が だとすると、これらのエントリ ポイントについて次のコードが生成されます。

• コンパイラは同等の を出力します。
• コンパイラは同等の を出力します。
• コンパイラは同等の を出力します。
• コンパイラは同等の を出力します。

コマンドライン引数

メソッドに引数を渡すには、次のいずれかの方法でメソッドを定義します。

引数を使用しない場合は、少し単純なコードのためにメソッド宣言から を省略できます。

メソッドのパラメーターは の配列で、コマンド ライン引数を表しています。 通常は、 プロパティをテストして、引数が存在するかどうかを判断します。次に例を示します。

if (args.Length == 0)
{
    System.Console.WriteLine("Please enter a numeric argument.");
    return 1;
}

また、 クラスまたは メソッドを使って、文字列型の引数を数値型に変換できます。 たとえば、次のステートメントでは、 メソッドを使用して を 値に変換します。

long num = Int64.Parse(args[0]);

C# 型（これはのエイリアスです）を使用することもできます。

long num = long.Parse(args[0]);

また、同じ変換に クラスの メソッドを使うこともできます。

long num = Convert.ToInt64(s);

詳細については、次のトピックを参照してください。 および

コンソール アプリケーションでコマンド ライン引数を使用する方法の例を次に示します。 アプリケーションは、実行時に引数を 1 つ受け取り、整数に変換し、その値の階乗を計算しています。 引数がない場合は、アプリケーションの正しい使用方法を説明するメッセージを表示します。

コマンド プロンプトからアプリケーションをコンパイルして実行するには、次の手順を実行します。

1. 次のコードをテキスト エディターに貼り付け、Factorial.cs という名前でテキスト ファイルとして保存します。

public class Functions
{
    public static long Factorial(int n)
    {
        // Test for invalid input.
        if ((n < 0) || (n > 20))
        {
            return -1;
        }

        // Calculate the factorial iteratively rather than recursively.
        long tempResult = 1;
        for (int i = 1; i <= n; i++)
        {
            tempResult *= i;
        }
        return tempResult;
    }
}

class MainClass
{
    static int Main(string[] args)
    {
        if (args.Length == 0)
        {
            Console.WriteLine("Please enter a numeric argument.");
            Console.WriteLine("Usage: Factorial <num>");
            return 1;
        }

        int num;
        bool test = int.TryParse(args[0], out num);
        if (!test)
        {
            Console.WriteLine("Please enter a numeric argument.");
            Console.WriteLine("Usage: Factorial <num>");
            return 1;
        }

        long result = Functions.Factorial(num);

        if (result == -1)
            Console.WriteLine("Input must be >= 0 and <= 20.");
        else
            Console.WriteLine($"The Factorial of {num} is {result}.");

        return 0;
    }
}

メソッドの開始時に、引数の長さをと比較して入力引数が指定されなかったかどうかをテストし、引数が見つからない場合はヘルプを表示します。
引数が指定されている場合 ( が 0 より大きい場合)、プログラムは入力引数を数値に変換しようとします。 この例では、引数が数値でない場合に例外をスローします。
階乗が計算された後、型の変数に格納されます。詳細な結果が変数に応じて出力されます。

1. Start 画面または Start メニューから、Visual Studio Developer コマンド プロンプト ウィンドウを開き、作成したファイルを含むフォルダーに移動します。

2. アプリケーションをコンパイルするには、次のコマンドを入力します。

   dotnet build

   アプリケーションにコンパイル エラーがない場合、ビルド プロセスによってFactorial.dllという名前のバイナリ ファイル が作成されます 。

3. 3 の階乗を計算する次のコマンドを入力します。

   dotnet run -- 3

4. プログラムの引数としてコマンド ラインに「3」と入力すると、次のように出力されます。

C# 言語仕様

詳細については、「C# 言語の仕様」を参照してください。 言語仕様は、C# の構文と使用法に関する信頼性のある情報源です。

関連項目

• System.Environment
• コマンド ライン引数を表示する方法