エディット コンティニュ (Visual C#)

ホット リロード (C# のエディット コンティニュ) を使用すると、デバッグ中に中断または実行モードでコードに変更を加えることができます。 デバッグ セッションを停止したり再開したりしなくても、変更を適用できます。

基本的なホット リロード エクスペリエンスは、ほとんどの種類の .NET アプリとフレームワーク バージョンで動作します。 これには、.NET Framework、.NET Core、.NET 5 以降 (該当する場合は C# と Visual Basic の両方) が含まれます。 このシナリオでは、デバッガーを使う場合、ホット リロードを利用できると想定して構いません。ぜひお試しください。

ホット リロードでは、デバッグ セッションで行う必要があるほとんどの変更がサポートされますが、いくつか例外があります。 たとえば、マネージド デバッガーとネイティブ デバッガーが有効になっている最適化されたコードやデバッグ セッションでは、ホット リロードはサポートされていません。

サポートされていないその他のシナリオについては、「サポートされているコード変更 (C# および Visual Basic)」を参照してください。 これらのシナリオのいずれかでコード変更を適用しようとすると、ホット リロードがサポートされていないことを示すメッセージ ボックスが表示されます。

ホット リロードを使用する

C# のホット リロードは、中断モードでコードの変更を行うと自動的に実行されます。その後、[続行][ステップ][次のステートメントの設定] のいずれかを使用してデバッグを続行します。 [ファイル保存時のホット リロード] を true に設定すると、ファイルの保存時にも自動的に実行されます。

ホット リロードを有効または無効にするには:

  1. デバッグ セッション中は、デバッグを停止します ([デバッグ]>[停止]、または Shift+F5 キー)。

  2. [ツール]>[オプション]>[デバッグ]>[.NET/C++ ホット リロード] を開き、[デバッグ時にホット リロードとエディット コンティニュを有効にする] チェック ボックスをオンまたはオフにします。

デバッグ セッションを開始または再開すると、この設定が有効になります。

従来のエディット コンティニュ エクスペリエンスを使用するには:

  1. デバッグ中は、中断モードでソース コードを変更します。

  2. [デバッグ] メニューから [続行][ステップ][次のステートメントの設定] のいずれかをクリックします。 その新しい、コンパイルされたコードでデバッグが続行されます。

エディット コンティニュでサポートされないコードの種類の変更もあります。 詳細については、「サポートされているコード変更 (C# および Visual Basic)」を参照してください。

C# のエディット コンティニュを使用すると、デバッグ中に中断または実行モードでコードに変更を加えることができます。 デバッグ セッションを停止したり再開したりしなくても、変更を適用できます。 実行モードでは、ソース エディターは読み取り専用です。

エディット コンティニュは、Windows 10 以降の UWP と、.NET Framework 4.6 デスクトップ以降のバージョンを対象とする x86 および x64 アプリでサポートされています (.NET Framework はデスクトップ バージョンのみです)。

エディット コンティニュは、デバッグ セッションで行う必要があるほとんどの変更をサポートしますが、いくつか例外があります。 最適化されたコード、混合コード、または SQL Server の共通言語ランタイム (CLR) との統合コードについては、エディット コンティニュはサポートされません。 サポートされていないその他のシナリオについては、「サポートされているコード変更 (C# および Visual Basic)」を参照してください。 これらのシナリオのいずれかでエディット コンティニュを適用しようとすると、エディット コンティニュがサポートされないことを伝えるメッセージ ボックスが表示されます。

サポートされていないその他のシナリオについては、「サポートされているコード変更 (C# および Visual Basic)」を参照してください。 これらのシナリオのいずれかでコード変更を適用しようとすると、ホット リロードがサポートされていないことを示すメッセージ ボックスが表示されます。

エディット コンティニュの使用

C# のエディット コンティニュは、中断モードでコードの変更を行うと自動的に発生します。その後、[続行][ステップ]、または [次のステートメントの設定] を使用してデバッグを続行するか、デバッガー ウィンドウで関数を評価します。

エディット コンティニュを有効または無効にするには:

  1. デバッグ セッション中は、デバッグを停止します ([デバッグ]>[停止]、または Shift+F5 キー)。

  2. [ツール]>[オプション] (または [デバッグ]>[オプション]) >[デバッグ]>[全般][エディット コンティニュを有効にする] チェックボックスをオンまたはオフにします。

デバッグ セッションを開始または再開すると、この設定が有効になります。

エディット コンティニュを使用するには:

  1. デバッグ中は、中断モードでソース コードを変更します。

  2. [デバッグ] メニューの [続行][ステップ]、または [次のステートメントの設定] をクリックするか、デバッガー ウィンドウに表示された関数を評価します。

    その新しい、コンパイルされたコードでデバッグが続行されます。

エディット コンティニュでサポートされないコードの種類の変更もあります。 詳細については、「サポートされているコード変更 (C# および Visual Basic)」を参照してください。