System.Diagnostics Namespace

O namespace System.Diagnostics fornece classes que permitem interagir com os processos do sistema, os logs de eventos e os contadores de desempenho. The System.Diagnostics namespace provides classes that allow you to interact with system processes, event logs, and performance counters.

Classes

Activity

Representa uma operação com contexto a ser usada para registro em log.Represents an operation with context to be used for logging.

BooleanSwitch

Fornece um comutador liga/desliga simples que controla a depuração e a saída de rastreamento.Provides a simple on/off switch that controls debugging and tracing output.

ConditionalAttribute

Indica a compiladores que um atributo ou chamada de método deve ser ignorado a menos que um símbolo de compilação condicional especificado seja definido.Indicates to compilers that a method call or attribute should be ignored unless a specified conditional compilation symbol is defined.

ConsoleTraceListener

Direciona a saída do rastreamento ou depuração para a saída padrão ou para o fluxo de erro padrão.Directs tracing or debugging output to either the standard output or the standard error stream.

CorrelationManager

Correlaciona rastreamentos que fazem parte de uma transação lógica.Correlates traces that are part of a logical transaction.

CounterCreationData

Define o tipo de contador, o nome e a cadeia de caracteres de ajuda para um contador personalizado.Defines the counter type, name, and Help string for a custom counter.

CounterCreationDataCollection

Fornece uma coleção fortemente tipada de objetos CounterCreationData.Provides a strongly typed collection of CounterCreationData objects.

CounterSampleCalculator

Fornece um conjunto de funções de utilitário para interpretar os dados do contador de desempenho.Provides a set of utility functions for interpreting performance counter data.

DataReceivedEventArgs

Fornece dados para os eventos de OutputDataReceived e de ErrorDataReceived .Provides data for the OutputDataReceived and ErrorDataReceived events.

Debug

Fornece um conjunto de métodos e propriedades que ajudam a depurar seu código.Provides a set of methods and properties that help debug your code.

DebuggableAttribute

Modifica a geração de código para depuração do tempo de execução JIT (just-in-time).Modifies code generation for runtime just-in-time (JIT) debugging. Essa classe não pode ser herdada.This class cannot be inherited.

Debugger

Habilita a comunicação com um depurador.Enables communication with a debugger. Essa classe não pode ser herdada.This class cannot be inherited.

DebuggerBrowsableAttribute

Determina se e como um membro é exibido nas janelas de variáveis do depurador.Determines if and how a member is displayed in the debugger variable windows. Essa classe não pode ser herdada.This class cannot be inherited.

DebuggerDisplayAttribute

Determina como uma classe ou campo é exibido nas janelas de variáveis do depurador.Determines how a class or field is displayed in the debugger variable windows.

DebuggerHiddenAttribute

Especifica o DebuggerHiddenAttribute.Specifies the DebuggerHiddenAttribute. Essa classe não pode ser herdada.This class cannot be inherited.

DebuggerNonUserCodeAttribute

Identifica um tipo ou membro que não faz parte do código de usuário para um aplicativo.Identifies a type or member that is not part of the user code for an application.

DebuggerStepperBoundaryAttribute

Indica que o código que segue o atributo deve ser executado no modo de execução, não em etapas.Indicates the code following the attribute is to be executed in run, not step, mode.

DebuggerStepThroughAttribute

Instrui o depurador a depurar o código em vez de avançar nele.Instructs the debugger to step through the code instead of stepping into the code. Essa classe não pode ser herdada.This class cannot be inherited.

DebuggerTypeProxyAttribute

Especifica o proxy de exibição para um tipo.Specifies the display proxy for a type.

DebuggerVisualizerAttribute

Especifica que o tipo tem um visualizador.Specifies that the type has a visualizer. Essa classe não pode ser herdada.This class cannot be inherited.

DefaultTraceListener

Fornece os métodos de saída padrão e o comportamento do rastreamento.Provides the default output methods and behavior for tracing.

DelimitedListTraceListener

Direciona a saída de rastreamento ou depuração para um gravador de texto, como um gravador de fluxo ou para um fluxo, como um fluxo de arquivos.Directs tracing or debugging output to a text writer, such as a stream writer, or to a stream, such as a file stream.

DiagnosticListener

Fornece uma implementação da classe DiagnosticSource abstrata que representa um local nomeado para o qual uma fonte envia suas informações (eventos).Provides an implementation of the abstract DiagnosticSource class that represents a named place to which a source sends its information (events).

DiagnosticsConfigurationHandler

Lida com a seção de diagnóstico dos arquivos de configuração.Handles the diagnostics section of configuration files.

DiagnosticSource

Uma classe abstrata que permite que o código seja instrumentado para registro em log de tempo de produção dos conteúdos de dados avançados para consumo dentro do processo que foi instrumentado.An abstract class that allows code to be instrumented for production-time logging of rich data payloads for consumption within the process that was instrumented.

EntryWrittenEventArgs

Fornece dados para o evento de EntryWritten .Provides data for the EntryWritten event.

EventInstance

Representa informações com neutralidade de idioma para uma entrada de log de eventos.Represents language-neutral information for an event log entry.

EventLog

Fornece interação com logs de eventos do Windows.Provides interaction with Windows event logs.

EventLogEntry

Encapsula um único registro no log de eventos.Encapsulates a single record in the event log. Essa classe não pode ser herdada.This class cannot be inherited.

EventLogEntryCollection

Define o tamanho e os enumeradores para uma coleção de instâncias EventLogEntry.Defines size and enumerators for a collection of EventLogEntry instances.

EventLogInstaller

Permite instalar e configurar um log de eventos que o aplicativo lê ou no qual faz gravações quando está em execução.Allows you to install and configure an event log that your application reads from or writes to when running.

EventLogPermission

Controla as permissões de acesso de código para o log de eventos.Controls code access permissions for event logging.

EventLogPermissionAttribute

Permite verificações de permissão declarativa para registro de eventos em log.Allows declarative permission checks for event logging.

EventLogPermissionEntry

Define a menor unidade de uma permissão de segurança de acesso do código definida para um EventLog.Defines the smallest unit of a code access security permission that is set for an EventLog.

EventLogPermissionEntryCollection

Contém uma coleção fortemente tipada de objetos EventLogPermissionEntry.Contains a strongly typed collection of EventLogPermissionEntry objects.

EventLogTraceListener

Fornece um ouvinte simples que direciona a saída do rastreamento ou da depuração para um EventLog.Provides a simple listener that directs tracing or debugging output to an EventLog.

EventSchemaTraceListener

Direciona a saída do rastreamento ou da depuração de eventos de ponta a ponta para um arquivo de log em conformidade com o esquema, codificado em XML.Directs tracing or debugging output of end-to-end events to an XML-encoded, schema-compliant log file.

EventSourceCreationData

Representa as configurações usadas para criar uma fonte de log de eventos no computador local ou em um computador remoto.Represents the configuration settings used to create an event log source on the local computer or a remote computer.

EventTypeFilter

Indica se um ouvinte deve rastrear com base no tipo de evento.Indicates whether a listener should trace based on the event type.

FileVersionInfo

Fornece informações de versão para um arquivo físico no disco.Provides version information for a physical file on disk.

InstanceData

Mantém os dados da instância associados a uma amostra do contador.Holds instance data associated with a performance counter sample.

InstanceDataCollection

Fornece uma coleção fortemente tipada de objetos InstanceData.Provides a strongly typed collection of InstanceData objects.

InstanceDataCollectionCollection

Fornece uma coleção fortemente tipada de objetos InstanceDataCollection.Provides a strongly typed collection of InstanceDataCollection objects.

MonitoringDescriptionAttribute

Especifica uma descrição de uma propriedade ou evento.Specifies a description for a property or event.

PerformanceCounter

Representa um componente do contador de desempenho do Windows NT.Represents a Windows NT performance counter component.

PerformanceCounterCategory

Representa um objeto de desempenho, que define uma categoria de contadores de desempenho.Represents a performance object, which defines a category of performance counters.

PerformanceCounterInstaller

Especifica um instalador para o componente PerformanceCounter.Specifies an installer for the PerformanceCounter component.

PerformanceCounterManager

Prepara os dados de desempenho para o performance.dll que o sistema carrega ao trabalhar com contadores de desempenho.Prepares performance data for the performance.dll the system loads when working with performance counters.

PerformanceCounterPermission

Permite controlar permissões de acesso de código para PerformanceCounter.Allows control of code access permissions for PerformanceCounter.

PerformanceCounterPermissionAttribute

Permite verificações de permissão de contador de desempenho declarativas.Allows declarative performance counter permission checks.

PerformanceCounterPermissionEntry

Define a menor unidade de uma permissão de segurança de acesso do código definida para um PerformanceCounter.Defines the smallest unit of a code access security permission that is set for a PerformanceCounter.

PerformanceCounterPermissionEntryCollection

Contém uma coleção fortemente tipada de objetos PerformanceCounterPermissionEntry.Contains a strongly typed collection of PerformanceCounterPermissionEntry objects.

PresentationTraceSources

Fornece suporte de rastreamento de depuração direcionado especificamente para aplicativos WPF (Windows Presentation Foundation).Provides debug tracing support that is specifically targeted for Windows Presentation Foundation (WPF) applications.

Process

Fornece acesso a processos locais e remotos e permite que você inicie e pare os processos do sistema local.Provides access to local and remote processes and enables you to start and stop local system processes.

ProcessModule

Representa um arquivo .dll ou .exe que é carregado em um processo específico.Represents a.dll or .exe file that is loaded into a particular process.

ProcessModuleCollection

Fornece uma coleção fortemente tipada de objetos ProcessModule.Provides a strongly typed collection of ProcessModule objects.

ProcessStartInfo

Especifica um conjunto de valores usados quando você inicia um processo.Specifies a set of values that are used when you start a process.

ProcessThread

Representa um thread de processo do sistema operacional.Represents an operating system process thread.

ProcessThreadCollection

Fornece uma coleção fortemente tipada de objetos ProcessThread.Provides a strongly typed collection of ProcessThread objects.

SourceFilter

Indica se um ouvinte deve rastrear uma mensagem com base na fonte de um rastreamento.Indicates whether a listener should trace a message based on the source of a trace.

SourceSwitch

Fornece uma opção em vários níveis para controlar o rastreamento e depurar a saída sem recompilar o código.Provides a multilevel switch to control tracing and debug output without recompiling your code.

StackFrame

Fornece informações sobre um StackFrame, que representa uma chamada de função na pilha de chamadas do thread atual.Provides information about a StackFrame, which represents a function call on the call stack for the current thread.

StackFrameExtensions

Fornece métodos de extensão para a classe StackFrame, que representa uma chamada de função na pilha de chamadas do thread atual.Provides extension methods for the StackFrame class, which represents a function call on the call stack for the current thread.

StackTrace

Representa um rastreamento de pilha, que é uma coleção ordenada de um ou mais registros de ativação.Represents a stack trace, which is an ordered collection of one or more stack frames.

Stopwatch

Fornece um conjunto de métodos e propriedades que você pode usar para medir com precisão o tempo decorrido.Provides a set of methods and properties that you can use to accurately measure elapsed time.

Switch

Fornece uma classe base abstrata para criar novos comutadores de rastreamento e depuração.Provides an abstract base class to create new debugging and tracing switches.

SwitchAttribute

Identifica uma opção usada em um assembly, classe ou membro.Identifies a switch used in an assembly, class, or member.

SwitchLevelAttribute

Identifica o tipo de nível para um comutador.Identifies the level type for a switch.

TextWriterTraceListener

Direciona a saída do rastreamento ou da depuração para um TextWriter ou um Stream, como FileStream.Directs tracing or debugging output to a TextWriter or to a Stream, such as FileStream.

Trace

Fornece um conjunto de métodos e propriedades que ajudam a rastrear a execução do código.Provides a set of methods and properties that help you trace the execution of your code. Essa classe não pode ser herdada.This class cannot be inherited.

TraceEventCache

Fornece dados de evento de rastreamento específicos para um processo e um thread.Provides trace event data specific to a thread and a process.

TraceFilter

Fornece a classe base para implementações de filtro de rastreamento.Provides the base class for trace filter implementations.

TraceListener

Fornece a classe base abstract para os ouvintes que monitoram o rastreamento e a saída da depuração.Provides the abstract base class for the listeners who monitor trace and debug output.

TraceListenerCollection

Fornece uma lista thread-safe de objetos TraceListener.Provides a thread-safe list of TraceListener objects.

TraceSource

Fornece um conjunto de métodos e propriedades que permitem que os aplicativos rastreiem a execução do código e associe mensagens de rastreamento à sua origem.Provides a set of methods and properties that enable applications to trace the execution of code and associate trace messages with their source.

TraceSwitch

Fornece uma opção em vários níveis para controlar o rastreamento e depurar a saída sem recompilar o código.Provides a multilevel switch to control tracing and debug output without recompiling your code.

UnescapedXmlDiagnosticData

Fornece os dados XML sem escape para registro em log de dados de rastreamento fornecidos por usuário.Provides unescaped XML data for the logging of user-provided trace data.

XmlWriterTraceListener

Direciona a saída de rastreamento ou de depuração como dados codificados em XML para um TextWriter ou Stream, como um FileStream.Directs tracing or debugging output as XML-encoded data to a TextWriter or to a Stream, such as a FileStream.

Estruturas

ActivitySpanId

Representa um SpanId formatado com base em um padrão W3C.Represents a SpanId formatted based on a W3C standard.

ActivityTraceId

Representa um TraceId cujo formato se baseia em um padrão W3C.Represents a TraceId whose format is based on a W3C standard.

CounterSample

Define uma estrutura que contém os dados brutos de um contador de desempenho.Defines a structure that holds the raw data for a performance counter.

Interfaces

ICollectData

Prepara os dados de desempenho para a DLL de desempenho que o sistema carrega ao trabalhar com contadores de desempenho.Prepares performance data for the performance DLL the system loads when working with performance counters.

Enumerações

ActivityIdFormat

Especifica o formato da propriedade Id.Specifies the format of the Id property.

ActivityTraceFlags

Especifica sinalizadores definidos pelo padrão W3C associados a uma atividade.Specifies flags defined by the W3C standard that are associated with an activity.

DebuggableAttribute.DebuggingModes

Especifica o modo de depuração para o compilador JIT (just-in-time).Specifies the debugging mode for the just-in-time (JIT) compiler.

DebuggerBrowsableState

Fornece instruções de exibição para o depurador.Provides display instructions for the debugger.

EventLogEntryType

Especifica o tipo de evento de uma entrada de log de eventos.Specifies the event type of an event log entry.

EventLogPermissionAccess

Define os níveis de acesso usados pelas classes de permissão EventLog.Defines access levels used by EventLog permission classes.

OverflowAction

Especifica como lidar com as entradas em um log de eventos que atingiu seu tamanho máximo do arquivo.Specifies how to handle entries in an event log that has reached its maximum file size.

PerformanceCounterCategoryType

Indica se a categoria do contador de desempenho pode ter várias instâncias.Indicates whether the performance counter category can have multiple instances.

PerformanceCounterInstanceLifetime

Especifica o tempo de vida de uma instância de contador de desempenho.Specifies the lifetime of a performance counter instance.

PerformanceCounterPermissionAccess

Define os níveis de acesso usados pelas classes de permissão PerformanceCounter .Defines access levels used by PerformanceCounter permission classes.

PerformanceCounterType

Especifica a fórmula usada para calcular o método NextValue() para uma instância PerformanceCounter.Specifies the formula used to calculate the NextValue() method for a PerformanceCounter instance.

PresentationTraceLevel

Descreve o nível de detalhes para rastreamento sobre um objeto específico.Describes the level of detail to trace about a particular object.

ProcessPriorityClass

Indica a prioridade que o sistema associa a um processo. Esse valor, junto com o valor de prioridade de cada thread do processo, determina o nível de prioridade básica de cada thread.This value, together with the priority value of each thread of the process, determines each thread's base priority level.

ProcessWindowStyle

Especifica como uma nova janela deve aparecer quando o sistema inicia um processo.Specified how a new window should appear when the system starts a process.

SourceLevels

Especifica os níveis de rastreamento de mensagens filtradas pelo comutador de origem e o filtro de tipo de evento.Specifies the levels of trace messages filtered by the source switch and event type filter.

ThreadPriorityLevel

Especifica o nível de prioridade de um thread.Specifies the priority level of a thread.

ThreadState

Especifica o estado de execução atual do thread.Specifies the current execution state of the thread.

ThreadWaitReason

Especifica o motivo pelo qual um thread está esperando.Specifies the reason a thread is waiting.

TraceEventType

Identifica o tipo de evento que causou o rastreamento.Identifies the type of event that has caused the trace.

TraceLevel

Especifica quais mensagens serão geradas para as classes Debug, Trace e TraceSwitch.Specifies what messages to output for the Debug, Trace and TraceSwitch classes.

TraceLogRetentionOption

Especifica a estrutura de arquivo que será usada para o log EventSchemaTraceListener.Specifies the file structure that will be used for the EventSchemaTraceListener log.

TraceOptions

Especifica opções de dados de rastreamento a serem gravados na saída de rastreamento.Specifies trace data options to be written to the trace output.

Delegados

DataReceivedEventHandler

Representa o método que manipulará o evento OutputDataReceived ou ErrorDataReceived de um Process.Represents the method that will handle the OutputDataReceived event or ErrorDataReceived event of a Process.

EntryWrittenEventHandler

Representa o método que manipulará o evento EntryWritten de um EventLog.Represents the method that will handle the EntryWritten event of an EventLog.

Comentários

  • O EventLog componente fornece a funcionalidade para gravar em logs de eventos, ler entradas de log de eventos e criar e excluir fontes de evento na rede e logs de eventos.The EventLog component provides functionality to write to event logs, read event log entries, and create and delete event logs and event sources on the network. O EntryWrittenEventHandler fornece uma maneira de interagir com logs de eventos de forma assíncrona.The EntryWrittenEventHandler provides a way to interact with event logs asynchronously. Classes de suporte fornecem acesso a controle mais detalhado, incluindo: restrições de permissão, a capacidade de especificar os tipos de log de eventos (que controla o tipo de dados padrão que foi escritos com uma entrada de log de eventos) e iterar por meio de coleções de log de eventos entradas.Supporting classes provide access to more detailed control, including: permission restrictions, the ability to specify event log types (which controls the type of default data that is written with an event log entry), and iterate through collections of event log entries. Para obter mais informações sobre essas tarefas, consulte a EventLogPermission, EventLogEntryType, e EventLogEntryCollection classes.For more information about these tasks, see the EventLogPermission, EventLogEntryType, and EventLogEntryCollection classes.

  • O Process classe fornece funcionalidade para monitorar os processos de sistema na rede e para iniciar e parar os processos do sistema local.The Process class provides functionality to monitor system processes across the network, and to start and stop local system processes. Além de recuperar listas de processos em execução (especificando o computador, para o nome do processo ou para a id do processo) ou exibir informações sobre o processo que atualmente tem acesso ao processador, você pode obter o conhecimento detalhado de threads de processo e módulos por meio de Process própria classe e por interagir com o ProcessThread e ProcessModule classes.In addition to retrieving lists of running processes (by specifying either the computer, the process name, or the process id) or viewing information about the process that currently has access to the processor, you can get detailed knowledge of process threads and modules both through the Process class itself, and by interacting with the ProcessThread and ProcessModule classes. O ProcessStartInfo classe permite que você especifique uma variedade de elementos com o qual iniciar um novo processo, como fluxos de entrada, saída e erro, diretórios de trabalho e verbos de linha de comando e argumentos.The ProcessStartInfo class enables you to specify a variety of elements with which to start a new process, such as input, output, and error streams, working directories, and command line verbs and arguments. Eles oferecem controle refinado sobre o comportamento de seus processos.These give you fine control over the behavior of your processes. Outras classes relacionadas permitem que você especifique estilos de janela, processo e prioridades do thread e interagir com coleções de threads e módulos.Other related classes let you specify window styles, process and thread priorities, and interact with collections of threads and modules.

  • O PerformanceCounter classe permite que você monitore o desempenho do sistema, enquanto o PerformanceCounterCategory classe fornece uma maneira de criar novos contadores personalizados e categorias.The PerformanceCounter class enables you to monitor system performance, while the PerformanceCounterCategory class provides a way to create new custom counters and categories. Você pode gravar no locais contadores personalizados e ler de contadores locais e remotos (sistema, bem como personalizada).You can write to local custom counters and read from both local and remote counters (system as well as custom). Você pode criar amostras de contadores usando o PerformanceCounter de classe e calculam os resultados de amostras de contador de desempenho sucessivos usando o CounterSample classe.You can sample counters using the PerformanceCounter class, and calculate results from successive performance counter samples using the CounterSample class. O CounterCreationData classe permite que você crie vários contadores em uma categoria e especifique seus tipos.The CounterCreationData class enables you to create multiple counters in a category and specify their types. Outras classes associados com o componente do contador de desempenho que fornecem acesso a conjuntos de contadores, permissão de contador e tipos de contador.Other classes associated with the performance counter component provide access to collections of counters, counter permission, and counter types.

O System.Diagnostics namespace também fornece classes que permitem a você para depurar seu aplicativo e para rastrear a execução do seu código.The System.Diagnostics namespace also provides classes that allow you to debug your application and to trace the execution of your code. Para obter mais informações, consulte as classes Trace e Debug.For more information, see the Trace and Debug classes.