DebugSettings Klasse
Definition
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.
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
- Attribute
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. |