DebugSettings Classe

Riferimento

Definizione

Spazio dei nomi:: Microsoft.UI.Xaml

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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(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

Ereditarietà: Object Platform::Object IInspectable DebugSettings

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute

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 this fa riferimento 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.

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.
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. Quando si attiva e si verifica un errore di associazione, l'evento viene generato e le `BindingFailed` informazioni sugli errori vengono registrate nell'output di debug nativo.
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.
IsXamlResourceReferenceTracingEnabled	Ottiene o imposta un valore che indica se coinvolgere la funzionalità di traccia delle risorse XAML di Microsoft Visual Studio quando l'app viene eseguita. Quando si verifica un errore di riferimento alla risorsa XAML, l'evento viene generato e le `XamlResourceReferenceFailed` informazioni sugli errori vengono registrate nell'output di debug nativo.
LayoutCycleDebugBreakLevel	Ottiene o imposta un valore che indica il livello di eventi di traccia del ciclo di layout che attivano un punto di interruzione del debugger.
LayoutCycleTracingLevel	Ottiene o imposta un valore che indica se la traccia del ciclo di layout viene scritta nel debugger nativo e il livello di dettaglio registrato.

Eventi

BindingFailed	Si verifica quando non è possibile risolvere un'associazione .
XamlResourceReferenceFailed	Si verifica quando non è possibile risolvere un riferimento a una risorsa XAML.

Si applica a

Condividi tramite