다음을 통해 공유

ASP.NET Core에 대한 .NET 핫 다시 로드 지원

.NET 핫 다시 로드는 앱을 다시 시작하지 않고 앱 상태를 잃지 않고 실행 중인 앱에 스타일시트 변경 내용을 포함한 코드 변경 내용을 적용합니다. .NET 6 이상을 사용하는 모든 ASP.NET Core에 대해 핫 다시 로드가 지원됩니다.

일반적으로 업데이트된 코드는 다음 조건에 따라 적용되도록 다시 실행됩니다.

  • 일부 시작 논리는 한 번만 실행됩니다.
    • 인라인 미들웨어 대리자로 코드 업데이트를 하지 않는 한 미들웨어입니다.
    • 구성된 서비스.
    • 코드 업데이트가 경로 처리기 대리자(예: OnInitialized)에 대한 것이 아닌 경우 경로 만들기 및 구성을 수행합니다.
  • 앱에서 Blazor프레임워크는 구성 요소 렌더링을Razor 자동으로 트리거합니다.
  • MVC 및 Razor Pages 앱에서 핫 다시 로드는 브라우저 새로 고침을 자동으로 트리거합니다.
  • Razor 구성 요소 매개 변수 특성을 제거해도 구성 요소가 다시 렌더링되지는 않습니다. 앱을 다시 시작해야 합니다.

지원되는 시나리오에 대한 자세한 내용은 지원되는 코드 변경(C# 및 Visual Basic)을 참조하세요.

Blazor WebAssembly

Blazor WebAssembly 핫 다시 로드는 다음 코드 변경 내용을 지원합니다.

  • 새 형식입니다.
  • 중첩 클래스입니다.
  • 변수, 식 및 문 추가, 제거 및 편집과 같은 메서드 본문에 대한 대부분의 변경 내용입니다.
  • 람다 식 및 로컬 함수의 본문을 변경합니다.
  • 기존 형식에 정적 및 인스턴스 메서드 추가
  • 기존 형식에 정적 및 인스턴스 필드, 이벤트 및 속성을 추가합니다.
  • 기존 메서드에 정적 람다 추가
  • 기존 메서드에 이미 this을 캡처한 상태에서 this을 캡처하는 람다를 추가합니다.

이전에 구성 요소 매개 변수의 값을 설정한 특성이 제거되면 구성 요소가 삭제되고 다시 초기화되어 제거된 매개 변수를 기본값으로 다시 설정합니다.

다음 코드 변경 내용은 Blazor WebAssembly 앱에서 지원되지 않습니다.

Blazor WebAssembly 핫 다시 로드는 다음 코드 변경 내용을 지원합니다.

  • 새 형식입니다.
  • 중첩 클래스입니다.
  • 변수, 식 및 문 추가, 제거 및 편집과 같은 메서드 본문에 대한 대부분의 변경 내용입니다.
  • 람다 식 및 로컬 함수의 본문을 변경합니다.
  • 기존 형식에 정적 및 인스턴스 메서드 추가
  • 기존 형식에 정적 필드 추가
  • 기존 메서드에 정적 람다 추가
  • 기존 메서드에 이미 this을 캡처한 상태에서 this을 캡처하는 람다를 추가합니다.

이전에 구성 요소 매개 변수의 값을 설정한 특성이 제거되면 구성 요소가 삭제되고 다시 초기화되어 제거된 매개 변수를 기본값으로 다시 설정합니다.

다음 코드 변경 내용은 Blazor WebAssembly 앱에서 지원되지 않습니다.

  • 새 await 연산 자 또는 yield 키워드 식 추가
  • 메서드 매개 변수의 이름을 변경합니다.
  • 인스턴스(비static) 필드, 이벤트 또는 속성 추가

Blazor WebAssembly 핫 다시 로드는 다음 코드 변경 내용을 지원합니다.

  • 변수, 식 및 문 추가, 제거 및 편집과 같은 메서드 본문에 대한 대부분의 변경 내용입니다.
  • 람다 식 및 로컬 함수의 본문을 변경합니다.

다음 코드 변경 내용은 Blazor WebAssembly 앱에서 지원되지 않습니다.

  • 새 람다 또는 로컬 함수 추가
  • 새 await 연산 자 또는 yield 키워드 식 추가
  • 메서드 매개 변수의 이름을 변경합니다.
  • 메서드 본문 외부의 변경 내용입니다.
  • 인스턴스(비static) 필드, 이벤트 또는 속성 추가

.NET CLI (.NET 명령줄 인터페이스)

"핫 리로드는 dotnet watch 명령을 사용하여 활성화됩니다."

dotnet watch

앱을 강제로 다시 빌드하고 다시 시작하려면 명령 셸에서 키보드 조합 Ctrl+R 을 사용합니다.

무례한 편집이라고 하는 지원되지 않는 코드 편집dotnet watch이 수행되면 앱을 다시 시작할 것인지 묻습니다.

  • 예: 앱을 다시 시작합니다.
  • 아니요: 앱을 다시 시작하지 않고 변경 내용을 적용하지 않고 앱을 실행합니다.
  • 항상: 무례한 편집이 발생할 때 필요에 따라 앱을 다시 시작합니다.
  • Never: 앱을 다시 시작하지 않고 향후 프롬프트를 방지합니다.

핫 다시 로드에 대한 지원을 사용하지 않으려면 --no-hot-reload 옵션을 dotnet watch 명령에 전달하십시오.

dotnet watch --no-hot-reload

핫 리로딩 비활성화

다음 설정은 Properties/launchSettings.json 핫 리로드를 비활성화합니다.

"hotReloadEnabled" : false

추가 리소스

자세한 내용은 Visual Studio 설명서에서 다음 리소스를 참조하세요.