DebugSettings Kelas

Referensi

Definisi

Ruang nama:: Microsoft.UI.Xaml

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

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

public ref class DebugSettings sealed

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DebugSettings final

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 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: ContractVersionAttribute MarshalingBehaviorAttribute

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 this lihat 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 bahkan jika Anda mengaktifkannya sebagai petak tanpa debugger.

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

Properti

EnableFrameRateCounter	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menampilkan info penggunaan CPU frame-rate dan per bingkai. Tampilan ini sebagai overlay penghitung di chrome jendela saat aplikasi berjalan.
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. Saat terlibat dan terjadi kesalahan pengikatan, `BindingFailed` peristiwa dimunculkan dan informasi kesalahan dicatat dalam output debug asli.
IsTextPerformanceVisualizationEnabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan melibatkan fitur visualisasi performa teks Microsoft Visual Studio saat aplikasi berjalan.
IsXamlResourceReferenceTracingEnabled	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan melibatkan fitur pelacakan referensi sumber daya XAML Microsoft Visual Studio saat aplikasi berjalan. Ketika terlibat dan kesalahan referensi sumber daya XAML terjadi, `XamlResourceReferenceFailed` peristiwa dinaikkan dan informasi kesalahan dicatat dalam output debug asli.
LayoutCycleDebugBreakLevel	Mendapatkan atau menetapkan nilai yang menunjukkan tingkat peristiwa pelacakan siklus tata letak yang memicu titik henti debugger.
LayoutCycleTracingLevel	Mendapatkan atau menetapkan nilai yang menunjukkan apakah pelacakan siklus tata letak ditulis ke debugger asli dan tingkat detail yang dicatat.

Acara

BindingFailed	Terjadi ketika Pengikatan tidak dapat diselesaikan.
XamlResourceReferenceFailed	Terjadi ketika referensi ke sumber daya XAML tidak dapat diselesaikan.

Berlaku untuk

Bagikan melalui