DebugSettings Klasse

  • Referenz

Definition

Namespace:
Windows.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(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
Vererbung
Object Platform::Object IInspectable DebugSettings
Attribute
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

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

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 Frameratecounter-Indikator in einer App angezeigt, die mit dieser Einstellung ausgeführt wird, auch wenn Sie ihn als Kachel ohne Debugger aktivieren.

Lassen Sie keine DebugSettings-Eigenschaften explizit im Produktionscode festgelegt.

Versionsverlauf

Windows-Version SDK-Version Wertschöpfung
1809 17763 FailFastOnErrors

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 als Überlagerung von Indikatoren im Fensterchrom angezeigt, während die App ausgeführt wird.
EnableRedrawRegions

Ruft einen Wert ab, der angibt, ob Bereiche der App-UI-Oberfläche hervorgehoben werden sollen, die jeden Frame neu gezeichnet werden, oder legt diesen fest.
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.
IsOverdrawHeatMapEnabled

Ruft einen Wert ab, der eine Debugeinstellung ermöglicht, die Überzeichnungsvorgänge visualisiert, oder legt diesen fest. Diese Visualisierung ist während der Anwendungsentwicklung nützlich, um Layouts, Animationen und andere Vorgänge zu erkennen, die grafikintensiv sind.
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.

Ereignisse

BindingFailed

Tritt auf, wenn eine Bindung nicht aufgelöst werden kann.

Gilt für:

Weitere Informationen