DebugSettings Classe

Definição

Namespace:

Windows.UI.Xaml

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(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)]
public sealed class DebugSettings

Public NotInheritable Class DebugSettings

Herança

Object Platform::Object IInspectable DebugSettings

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

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, isso se refere 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 que é executado com essa configuração mesmo se você ativá-lo como um bloco sem o depurador.

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

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1809	17763	FailFastOnErrors

Propriedades

EnableFrameRateCounter	Obtém ou define um valor que indica se é necessário exibir informações de uso de CPU por quadro e taxa de quadros. Eles são exibidos como uma sobreposição de contadores no cromado da janela enquanto o aplicativo é executado.
EnableRedrawRegions	Obtém ou define um valor que indica se as áreas da superfície da interface do usuário do aplicativo que estão sendo redesenhadas em cada quadro devem ser realçadas.
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 ativado quando o aplicativo é executado.
IsOverdrawHeatMapEnabled	Obtém ou define um valor que habilita uma configuração de depuração que visualiza operações de overdraw. Essa visualização é útil durante o desenvolvimento de aplicativos para detectar layout, animação e outras operações que fazem uso intensivo de processamento gráfico.
IsTextPerformanceVisualizationEnabled	Obtém ou define um valor que indica se o recurso de visualização de desempenho de texto do Microsoft Visual Studio deve ser envolvido quando o aplicativo é executado.

Eventos

BindingFailed

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

Confira também

• DebugSettings
• Vinculação de dados em detalhes
• Práticas recomendadas de desempenho para