Freigeben über

DebugSettings Klasse

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
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:

Weitere Informationen