다음을 통해 공유

DebugSettings 클래스

  • 참조

정의

네임스페이스:
Windows.UI.Xaml
편집

앱이 디버그 환경에서 실행되면 앱의 특정 측면이 작동하는 방식을 선언합니다.

public ref class DebugSettings sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DebugSettings final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DebugSettings final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DebugSettings
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DebugSettings
Public NotInheritable Class DebugSettings
상속
Object Platform::Object IInspectable DebugSettings
특성
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리
Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

이 예제에서는 Application.DebugSettings에 액세스하고 Singleton DebugSettings 값의 두 속성을 true로 설정하는 OnLaunched 재정의를 보여 줍니다. 이 코드의 컨텍스트는 app.xaml 코드 숨 김이므로 앱 에 대해 생성된 Application 개체를 참조합니다.

protected override void OnLaunched(LaunchActivatedEventArgs args) {
    this.DebugSettings.EnableFrameRateCounter = true;
    this.DebugSettings.IsOverdrawHeatMapEnabled = true;
    //...
}

설명

이 클래스는 생성할 수 없습니다. Application.DebugSettings에서 값을 가져와서 필요에 따라 속성을 변경합니다.

OnLaunched 는 DebugSettings 값을 변경하는 데 적합합니다.

DebugSettings에서 사용하도록 설정된 모든 모드에서 디버거를 연결해야 하는 것은 아닙니다. 예를 들어 EnableFrameRateCounter 와 연결된 프레임 속도 카운터는 디버거 없이 타일로 활성화하더라도 해당 설정으로 실행되는 앱에 표시됩니다.

프로덕션 코드에 명시적으로 설정된 DebugSettings 속성을 그대로 두지 마세요.

버전 기록

Windows 버전 SDK 버전 추가된 값
1809 17763 FailFastOnErrors

속성

EnableFrameRateCounter

프레임 속도 및 프레임당 CPU 사용량 정보를 표시할지 여부를 나타내는 값을 가져오거나 설정합니다. 이러한 디스플레이는 앱이 실행되는 동안 창 크롬에 카운터 오버레이로 표시됩니다.
EnableRedrawRegions

각 프레임에 다시 그려지는 앱 UI 화면의 영역을 강조 표시할지 여부를 나타내는 값을 가져오거나 설정합니다.
FailFastOnErrors

XAML 오류로 인해 오류를 반환하는 대신 즉시 FailFast가 발생하는지 여부를 나타내는 값을 가져오거나 설정합니다.
IsBindingTracingEnabled

앱이 실행되면 Microsoft Visual Studio의 바인딩 추적 기능을 사용할지 여부를 나타내는 값을 가져오거나 설정합니다.
IsOverdrawHeatMapEnabled

초과 그리기 작업을 시각화하는 디버그 설정을 사용하도록 설정하는 값을 가져오거나 설정합니다. 이 시각화는 그래픽 처리 집약적인 레이아웃, 애니메이션 및 기타 작업을 검색하는 데 애플리케이션 개발 중에 유용합니다.
IsTextPerformanceVisualizationEnabled

앱이 실행되면 Microsoft Visual Studio의 텍스트 성능 시각화 기능을 사용할지 여부를 나타내는 값을 가져오거나 설정합니다.

이벤트

BindingFailed

바인딩을 확인할 수 없는 경우에 발생합니다.

적용 대상

추가 정보