Partilhar via

DebugSettings Classe

  • Referência

Definição

Namespace:
Microsoft.UI.Xaml
Editar

Declara como determinados aspectos do aplicativo se comportam quando ele é executado em um ambiente de depuração

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
Herança
Object Platform::Object IInspectable DebugSettings
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute

Exemplos

Este exemplo mostra uma substituição OnLaunched que acessa Application.DebugSettings e define duas propriedades do valor singleton DebugSettings como true. O contexto desse código é o code-behind app.xaml, portanto this , refere-se ao objeto Application criado para o aplicativo.

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

Comentários

Essa classe não pode ser construída. Obtenha o valor de Application.DebugSettings e altere as propriedades conforme necessário.

OnLaunched é um bom lugar para alterar os valores de DebugSettings.

Nem todos os modos habilitados por DebugSettings exigem que um depurador esteja anexado. Por exemplo, o contador de taxa de quadros associado a EnableFrameRateCounter aparecerá em um aplicativo executado com essa configuração mesmo se você ativá-lo como um bloco sem o depurador.

Não deixe nenhuma propriedade DebugSettings definida explicitamente em seu código de produção.

Propriedades

EnableFrameRateCounter

Obtém ou define um valor que indica se a taxa de quadros e as informações de uso da CPU por quadro devem ser exibidas. Eles são exibidos como uma sobreposição de contadores no cromado da janela enquanto o aplicativo é executado.
FailFastOnErrors

Obtém ou define um valor que indica se erros XAML causam um FailFast imediato em vez de retornar um erro.
IsBindingTracingEnabled

Obtém ou define um valor que indica se o recurso de rastreamento de associação do Microsoft Visual Studio deve ser envolvido quando o aplicativo é executado. Quando envolvido e ocorre um erro de associação, o BindingFailed evento é gerado e as informações de erro são registradas na saída de depuração nativa.
IsTextPerformanceVisualizationEnabled

Obtém ou define um valor que indica se o recurso de visualização de desempenho de texto deve ser envolvido no Microsoft Visual Studio quando o aplicativo é executado.
IsXamlResourceReferenceTracingEnabled

Obtém ou define um valor que indica se o recurso de rastreamento de referência de recurso XAML deve ser envolvido no Microsoft Visual Studio quando o aplicativo é executado. Quando um erro de referência de recurso XAML ocorre, o XamlResourceReferenceFailed evento é gerado e as informações de erro são registradas na saída de depuração nativa.
LayoutCycleDebugBreakLevel

Obtém ou define um valor que indica o nível de eventos de rastreamento do ciclo de layout que disparam um ponto de interrupção do depurador.
LayoutCycleTracingLevel

Obtém ou define um valor que indica se o rastreamento do ciclo de layout é gravado no depurador nativo e o nível de detalhes que é registrado.

Eventos

BindingFailed

Ocorre quando uma Associação não pode ser resolvida.
XamlResourceReferenceFailed

Ocorre quando uma referência a um recurso XAML não pode ser resolvida.

Aplica-se a

Confira também