DebugSettings Klasse

Referenz

Definition

Namespace:: Microsoft.UI.Xaml

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Deklariert, wie sich bestimmte Aspekte der App verhalten, wenn sie in einer Debugumgebung ausgeführt wird

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

Vererbung: Object Platform::Object IInspectable DebugSettings

Attribute: ContractVersionAttribute MarshalingBehaviorAttribute

Beispiele

Dieses Beispiel zeigt eine OnLaunched-Überschreibung , die auf Application.DebugSettings zugreift und zwei Eigenschaften des Singleton-DebugSettings-Werts auf truefestlegt. Der Kontext dieses Codes ist der CodeBehind app.xaml, bezieht sich also this auf das erstellte Application-Objekt für die App.

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

Hinweise

Diese Klasse kann nicht erstellt werden. Rufen Sie den Wert aus Application.DebugSettings ab, und ändern Sie dann die Eigenschaften nach Bedarf.

OnLaunched ist ein guter Ort, um DebugSettings-Werte zu ändern.

Nicht alle Modi, die von DebugSettings aktiviert werden, erfordern, dass ein Debugger angefügt ist. Beispielsweise wird der Mit EnableFrameRateCounter zugeordnete Frameratenzähler in einer App angezeigt, die mit dieser Einstellung ausgeführt wird, auch wenn Sie ihn als Kachel ohne den Debugger aktivieren.

Lassen Sie debugSettings-Eigenschaften nicht explizit im Produktionscode festgelegt.

Eigenschaften

EnableFrameRateCounter	Ruft einen Wert ab, der angibt, ob Informationen zur Framerate und CPU-Auslastung pro Frame angezeigt werden sollen, oder legt diesen fest. Diese werden während der Ausführung der App als Überlagerung von Leistungsindikatoren im Fensterchrom angezeigt.
FailFastOnErrors	Ruft einen Wert ab, der angibt, ob XAML-Fehler ein sofortiges FailFast verursachen, anstatt einen Fehler zurückzugeben, oder legt diesen fest.
IsBindingTracingEnabled	Ruft einen Wert ab, der angibt, ob die Bindungsablaufverfolgungsfunktion von Microsoft Visual Studio verwendet werden soll, wenn die App ausgeführt wird, oder legt diesen fest. Wenn aktiviert und ein Bindungsfehler auftritt, wird das `BindingFailed` Ereignis ausgelöst, und Fehlerinformationen werden in der nativen Debugausgabe protokolliert.
IsTextPerformanceVisualizationEnabled	Ruft einen Wert ab, der angibt, ob die Textleistungsvisualisierungsfunktion von Microsoft Visual Studio verwendet werden soll, wenn die App ausgeführt wird, oder legt diesen fest.
IsXamlResourceReferenceTracingEnabled	Ruft einen Wert ab, der angibt, ob die XAML-Ressourcenverweisablaufverfolgungsfunktion von Microsoft Visual Studio verwendet werden soll, wenn die App ausgeführt wird, oder legt diesen fest. Wenn aktiviert und ein XAML-Ressourcenverweisfehler auftritt, wird das `XamlResourceReferenceFailed` Ereignis ausgelöst, und Fehlerinformationen werden in der nativen Debugausgabe protokolliert.
LayoutCycleDebugBreakLevel	Ruft einen Wert ab, der die Ebene der Ablaufverfolgungsereignisse des Layoutzyklus angibt, die einen Debuggerhaltepunkt auslösen, oder legt diesen fest.
LayoutCycleTracingLevel	Ruft einen Wert ab, der angibt, ob die Layoutzyklusablaufverfolgung in den nativen Debugger geschrieben wird, und die aufgezeichnete Detailebene, oder legt diesen fest.

Ereignisse

BindingFailed	Tritt auf, wenn eine Bindung nicht aufgelöst werden kann.
XamlResourceReferenceFailed	Tritt auf, wenn ein Verweis auf eine XAML-Ressource nicht aufgelöst werden kann.

Gilt für:

Freigeben über