DebugSettings Classe

  • Referência

Definição

Namespace:
Windows.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(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
Herança
Object Platform::Object IInspectable DebugSettings
Atributos
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Aplica-se a

Confira também