Bagikan melalui


DebugSettings Kelas

Definisi

Menyatakan bagaimana aspek tertentu dari aplikasi berperilaku saat dijalankan di lingkungan debug

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
Warisan
Object Platform::Object IInspectable DebugSettings
Atribut

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh ini menunjukkan penimpaan OnLaunched yang mengakses Application.DebugSettings dan mengatur dua properti dari nilai DebugSettings singleton ke true. Konteks kode ini adalah app.xaml code-behind, jadi ini mengacu pada objek Aplikasi yang dibuat untuk aplikasi.

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

Keterangan

Kelas ini tidak dapat dibangun. Dapatkan nilai dari Application.DebugSettings lalu ubah properti seperlunya.

OnLaunched adalah tempat yang baik untuk mengubah nilai DebugSettings.

Tidak semua mode yang diaktifkan oleh DebugSettings mengharuskan debugger terpasang. Misalnya, penghitung kecepatan bingkai yang terkait dengan EnableFrameRateCounter akan muncul di aplikasi yang berjalan dengan pengaturan tersebut meskipun Anda mengaktifkannya sebagai ubin tanpa debugger.

Jangan biarkan properti DebugSettings secara eksplisit diatur dalam kode produksi Anda.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1809 17763 FailFastOnErrors

Properti

EnableFrameRateCounter

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menampilkan info penggunaan CPU kecepatan bingkai dan per bingkai. Tampilan ini sebagai overlay penghitung di chrome jendela saat aplikasi berjalan.

EnableRedrawRegions

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menyoroti area permukaan UI aplikasi yang sedang digambar ulang setiap bingkai.

FailFastOnErrors

Mendapatkan atau menetapkan nilai yang menunjukkan apakah kesalahan XAML menyebabkan FailFast langsung daripada mengembalikan kesalahan.

IsBindingTracingEnabled

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan melibatkan fitur pelacakan pengikatan Microsoft Visual Studio saat aplikasi berjalan.

IsOverdrawHeatMapEnabled

Mendapatkan atau menetapkan nilai yang memungkinkan pengaturan debug yang memvisualisasikan operasi overdraw. Visualisasi ini berguna selama pengembangan aplikasi untuk mendeteksi tata letak, animasi, dan operasi lain yang pemrosesan grafis intensif.

IsTextPerformanceVisualizationEnabled

Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan melibatkan fitur visualisasi performa teks Microsoft Visual Studio saat aplikasi berjalan.

Acara

BindingFailed

Terjadi ketika Pengikatan tidak dapat diselesaikan.

Berlaku untuk

Lihat juga