DebugSettings Classe

  • Riferimento

Definizione

Spazio dei nomi:
Windows.UI.Xaml
Modifica

Dichiara il comportamento di alcuni aspetti dell'app quando viene eseguito in un ambiente di 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
Ereditarietà
Object Platform::Object IInspectable DebugSettings
Attributi
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

In questo esempio viene illustrato un override onLaunched che accede a Application.DebugSettings e imposta due proprietà del valore DebugSettings singleton su true. Il contesto di questo codice è il code-behind app.xaml, quindi si riferisce all'oggetto Application creato per l'app.

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

Commenti

Questa classe non può essere costruita. Ottenere il valore da Application.DebugSettings e quindi modificare le proprietà in base alle esigenze.

OnLaunched è un buon posto per modificare i valori DebugSettings.

Non tutte le modalità abilitate da DebugSettings richiedono che un debugger sia collegato. Ad esempio, il contatore della frequenza di frame associato a EnableFrameRateCounter verrà visualizzato in un'app che viene eseguita con tale impostazione anche se la si attiva come riquadro senza il debugger.

Non lasciare le proprietà DebugSettings impostate in modo esplicito nel codice di produzione.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1809 17763 FailFastOnErrors

Proprietà

EnableFrameRateCounter

Ottiene o imposta un valore che indica se visualizzare le informazioni sull'utilizzo della CPU per fotogrammi e per frame. Questi vengono visualizzati come sovrapposizione di contatori nella finestra chrome durante l'esecuzione dell'app.
EnableRedrawRegions

Ottiene o imposta un valore che indica se evidenziare le aree dell'area dell'interfaccia utente dell'app che vengono ridisegnate ogni cornice.
FailFastOnErrors

Ottiene o imposta un valore che indica se gli errori XAML causano un errore failfast immediato anziché restituire un errore.
IsBindingTracingEnabled

Ottiene o imposta un valore che indica se coinvolgere la funzionalità di traccia di associazione di Microsoft Visual Studio quando l'app viene eseguita.
IsOverdrawHeatMapEnabled

Ottiene o imposta un valore che consente un'impostazione di debug che visualizza le operazioni di overdraw. Questa visualizzazione è utile durante lo sviluppo di applicazioni per rilevare layout, animazione e altre operazioni che sono intensivo nell'elaborazione grafica.
IsTextPerformanceVisualizationEnabled

Ottiene o imposta un valore che indica se coinvolgere la funzionalità di visualizzazione delle prestazioni del testo di Microsoft Visual Studio quando l'app viene eseguita.

Eventi

BindingFailed

Si verifica quando non è possibile risolvere un'associazione .

Si applica a

Vedi anche