DebugSettings Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- Atributos
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. |