System.Diagnostics Пространство имен

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности.

Классы

Имя	Описание
Activity	Представляет операцию и связанный с ней контекст, используемые для журналирования.
ActivityListener	Позволяет отслеживать события запуска и остановки активности и определять, следует ли создавать активность для сценариев сэмплирования.
ActivitySource	Предоставляет API для создания и запуска Activity объектов и регистрации ActivityListener объектов для прослушивания Activity событий.
ActivitySourceOptions	Параметры создания ActivitySource.
ActivityTagsCollection	ActivityTagsCollection — это класс коллекции, используемый для хранения тегов трассировки. Эта коллекция будет использоваться с классами, такими как ActivityEvent и ActivityLink. Эта коллекция ведет себя следующим образом: Элементы коллекции будут упорядочены в соответствии с порядком их добавления. Не допускайте дублирования элементов с одинаковым ключом. При использовании индексатора для хранения элемента в коллекции: Если элемент имеет ключ, который ранее существовал в коллекции, и значение равно `null`, элемент коллекции, соответствующий ключу, будет удален из коллекции. Если элемент имеет ключ, который ранее существовал в коллекции, и значение не `null`является, новое значение элемента заменит старое значение, хранящееся в коллекции. В противном случае элемент будет добавлен в коллекцию. Метод добавления добавит в коллекцию новый элемент, если элемент с таким же ключом еще не существует. В противном случае будет вызвано исключение.
BooleanSwitch	Предоставляет простой выключатель, управляющий результатами отладки и трассировки.
ConditionalAttribute	Указывает компиляторам, что вызов метода или атрибут следует игнорировать, если не определен заданный символ условной компиляции.
ConsoleTraceListener	Направляет вывод трассировки или отладки либо в стандартный поток вывода, либо в стандартный поток ошибок.
CorrelationManager	Устанавливает корреляцию между трассировками, являющимися частью логической транзакции.
CounterCreationData	Определяет тип счетчика, имя и строку справки для настраиваемого счетчика.
CounterCreationDataCollection	Предоставляет строго типизированную коллекцию CounterCreationData объектов.
CounterSampleCalculator	Предоставляет набор служебных функций для интерпретации данных счетчика производительности.
DataReceivedEventArgs	Предоставляет данные для событий OutputDataReceived и ErrorDataReceived.
Debug	Предоставляет набор методов и свойств, помогающих при отладке кода.
DebuggableAttribute	Изменяет создание кода для JIT-отладки среды выполнения. Этот класс не наследуется.
Debugger	Разрешает взаимодействие с отладчиком. Этот класс не наследуется.
DebuggerBrowsableAttribute	Определяет, будет ли член отображаться в окнах переменных отладчика и каким образом. Этот класс не наследуется.
DebuggerDisableUserUnhandledExceptionsAttribute	Если отладчик .NET подключен, поддерживающий API BreakForUserUnhandledException(Exception), отладчик не будет прерывать необработанные пользователем исключения, если исключение перехватывается методом с этим атрибутом, если не вызывается BreakForUserUnhandledException(Exception).
DebuggerDisplayAttribute	Определяет, как класс или поле отображается в окнах переменных отладчика.
DebuggerHiddenAttribute	Указывает DebuggerHiddenAttribute. Этот класс не наследуется.
DebuggerNonUserCodeAttribute	Определяет тип или член, который не является частью пользовательского кода для приложения.
DebuggerStepperBoundaryAttribute	Указывает код, следующий за атрибутом, который должен выполняться в режиме выполнения, а не в пошаговом режиме.
DebuggerStepThroughAttribute	Указывает отладчику выполнять код пошагово, не заходя в вызываемый код. Этот класс не наследуется.
DebuggerTypeProxyAttribute	Указывает прокси отображения для типа.
DebuggerVisualizerAttribute	Указывает, что тип имеет визуализатор. Этот класс не наследуется.
DefaultTraceListener	Предоставляет методы вывода по умолчанию и поведение для трассировки.
DelimitedListTraceListener	Направляет выходные данные трассировки или отладки в объект записи текста, например в объект записи в поток, либо в поток, например в файловый поток.
DiagnosticListener	Предоставляет реализацию абстрактного DiagnosticSource класса, представляющего именованное место, в которое источник отправляет информацию (события).
DiagnosticListenerExtensions	Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности.
DiagnosticMethodInfo	Представляет диагностические сведения о методе. Сведения, предоставляемые этим классом, похожи на сведения предоставляется MethodBase , но он предназначен для ведения журнала и трассировки.
DiagnosticsConfigurationHandler	Обрабатывает раздел диагностики файлов конфигурации.
DiagnosticSource	Абстрактный класс, позволяющий инструментировать код для журналирования в рабочей среде подробных полезных нагрузок данных, предназначенных для использования в том же инструментированном процессе.
DistributedContextPropagator	DistributedContextPropagator Реализация определяет, кодируется ли и как распределенная информация контекста закодирована и декодирована по мере того, как она проходит по сети. Кодировка может передаваться по любому сетевому протоколу, который поддерживает пары строк "ключ — значение". Например, при использовании HTTP каждая пара "ключ — значение" является заголовком HTTP. DistributedContextPropagator внедряет значения в и извлекает значения из операторов в виде строковых пар "ключ-значение".
EntryWrittenEventArgs	Предоставляет данные для EntryWritten события.
EventInstance	Представляет сведения, нейтральные на языке, для записи журнала событий.
EventLog	Обеспечивает взаимодействие с журналами событий Windows.
EventLogEntry	Инкапсулирует одну запись в журнале событий. Этот класс не наследуется.
EventLogEntryCollection	Определяет размер и перечислители для коллекции EventLogEntry экземпляров.
EventLogInstaller	Позволяет установить и настроить журнал событий, который приложение считывает или записывает в нее при запуске.
EventLogPermission	Управляет разрешениями на доступ к коду для ведения журнала событий.
EventLogPermissionAttribute	Разрешает декларативные проверки разрешений для ведения журнала событий.
EventLogPermissionEntry	Определяет наименьшую единицу разрешения на доступ к коду, заданного EventLogдля параметра .
EventLogPermissionEntryCollection	Содержит строго типизированную коллекцию EventLogPermissionEntry объектов.
EventLogTraceListener	Предоставляет простой прослушиватель, который направляет выходные данные трассировки или отладки в объект EventLog.
EventSchemaTraceListener	Направляет выходные данные трассировки или отладки сквозных событий в XML-кодированный файл журнала, соответствующий схеме.
EventSourceCreationData	Представляет параметры конфигурации, используемые для создания источника журнала событий на локальном компьютере или удаленном компьютере.
EventTypeFilter	Указывает, должен ли прослушиватель трассировать на основе типа события.
FileVersionInfo	Предоставляет сведения о версии физического файла на диске.
InitializingSwitchEventArgs	Предоставляет данные для события Switch.Initializing .
InitializingTraceSourceEventArgs	Предоставляет данные для события TraceSource.Initializing .
InstanceData	Содержит данные экземпляра, связанные с примером счетчика производительности.
InstanceDataCollection	Предоставляет строго типизированную коллекцию InstanceData объектов.
InstanceDataCollectionCollection	Предоставляет строго типизированную коллекцию InstanceDataCollection объектов.
MonitoringDescriptionAttribute	Задает описание для свойства или события.
PerformanceCounter	Представляет компонент счетчика производительности NT Windows.
PerformanceCounterCategory	Представляет объект производительности, определяющий категорию счетчиков производительности.
PerformanceCounterInstaller	Устанавливает программу установки для компонента PerformanceCounter.
PerformanceCounterManager	Подготавливает данные о производительности для performance.dll системе загружается при работе с счетчиками производительности.
PerformanceCounterPermission	Разрешает управление разрешениями на доступ к коду для PerformanceCounter.
PerformanceCounterPermissionAttribute	Разрешает декларативные проверки разрешений счетчика производительности.
PerformanceCounterPermissionEntry	Определяет наименьшую единицу разрешения на доступ к коду, заданного для параметра PerformanceCounter.
PerformanceCounterPermissionEntryCollection	Содержит строго типизированную коллекцию PerformanceCounterPermissionEntry объектов.
PresentationTraceSources	Предоставляет поддержку трассировки отладки, предназначенную специально для приложений Windows Presentation Foundation (WPF).
Process	Предоставляет доступ к локальным и удаленным процессам и позволяет запускать и останавливать локальные системные процессы.
ProcessExitStatus	Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности.
ProcessModule	Представляет DLL- или EXE-файл, который загружается в определенный процесс.
ProcessModuleCollection	Предоставляет строго типизированную коллекцию ProcessModule объектов.
ProcessStartInfo	Задает набор значений, используемых при запуске процесса.
ProcessTextOutput	Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности.
ProcessThread	Представляет поток процесса операционной системы.
ProcessThreadCollection	Предоставляет строго типизированную коллекцию ProcessThread объектов.
SourceFilter	Указывает, следует ли прослушивателю выполнять трассировку сообщения в зависимости от источника трассировки.
SourceSwitch	Предоставляет переключатель с несколькими уровнями для управления выводом трассировочных и отладочных данных без перекомпиляции кода.
StackFrame	Предоставляет сведения о вызове StackFrameфункции в стеке вызовов для текущего потока.
StackFrameExtensions	Предоставляет методы расширения для StackFrame класса, который представляет вызов функции в стеке вызовов для текущего потока.
StackTrace	Представляет трассировку стека, которая является упорядоченным набором из одного или нескольких кадров стека.
StackTraceHiddenAttribute	Типы и методы, связанные с StackTraceHidden, будут опущены в тексте трассировки стека, отображаемом в StackTrace.ToString() и Exception.StackTrace.
Stopwatch	Предоставляет набор методов и свойств, которые можно использовать для точного измерения затраченного времени.
Switch	Предоставляет абстрактный базовый класс для создания новых переключателей отладки и трассировки.
SwitchAttribute	Определяет переключатель, используемый в сборке, классе или члене.
SwitchLevelAttribute	Идентифицирует тип уровня переключателя.
TextWriterTraceListener	Направляет выходные данные трассировки или отладки в объект или TextWriter в объект Stream, например FileStream.
Trace	Предоставляет набор методов и свойств, которые помогают отслеживать выполнение вашего кода. Этот класс не наследуется.
TraceConfiguration	Предоставляет методы для регистрации и настройки параметров трассировки из файлов TraceSource конфигурации и связанных классов.
TraceEventCache	Предоставляет данные события трассировки, относящиеся к потоку и процессу.
TraceFilter	Предоставляет базовый класс для реализации фильтров трассировки.
TraceListener	Предоставляет базовый класс для прослушивателей, отслеживающих выходные `abstract` данные трассировки и отладки.
TraceListenerCollection	Предоставляет потокобезопасный TraceListener список объектов.
TraceSource	Предоставляет набор методов и свойств, позволяющих приложениям отслеживать выполнение кода и связывать сообщения трассировки с их источником.
TraceSwitch	Предоставляет переключатель с несколькими уровнями для управления выводом трассировочных и отладочных данных без перекомпиляции кода.
UnescapedXmlDiagnosticData	Предоставляет неискаченные XML-данные для ведения журнала предоставленных пользователем данных трассировки.
UnreachableException	Исключение, которое возникает, когда программа выполняет инструкцию, которая считалась недоступной.
XmlWriterTraceListener	Направляет выходные данные трассировки или отладки в виде xml-кодированных данных в объект TextWriter или в объект Stream, например FileStream.

Структуры

Имя	Описание
Activity.Enumerator<T>	Перечисляет данные, хранящиеся в объекте Activity.
ActivityChangedEventArgs	Предоставляет данные для CurrentChanged события.
ActivityContext	Представление, соответствующее спецификации TraceContext W3C. Он содержит два идентификатора: TraceId и SpanId, а также набор общих значений TraceFlags и system-specific TraceState.
ActivityCreationOptions<T>	Инкапсулирует все сведения, отправляемые прослушивателю действий, для принятия решений о создании экземпляра действия, а также его состояния. Возможные параметры универсального типа ActivityContext или String.
ActivityEvent	Представляет событие, содержащее имя и метку времени, а также необязательный список тегов.
ActivityLink	Действия могут быть связаны с нулевыми или более экземплярами контекста действия, которые связаны с причинно-связанными. Ссылки на действия могут указывать на контексты действий внутри одной трассировки или между различными трассировками. Ссылки на действия можно использовать для представления пакетных операций, в которых действие было инициировано несколькими инициирующими действиями, каждый из которых представляет один входящий элемент, обрабатываемый в пакете.
ActivitySpanId	Представляет SpanId формат на основе стандарта W3C.
ActivityTagsCollection.Enumerator	Перечисляет элементы объекта `ActivityTagsCollection`.
ActivityTraceId	Представляет TraceId, формат которого основан на стандарте W3C.
CounterSample	Определяет структуру, содержащую необработанные данные для счетчика производительности.
Debug.AssertInterpolatedStringHandler	Предоставляет интерполированный обработчик строки для Assert(Boolean), который выполняет форматирование только в случае сбоя утверждения.
Debug.WriteIfInterpolatedStringHandler	Предоставляет интерполированный обработчик строк для WriteIf(Boolean, String) и WriteLineIf(Boolean, Object), который выполняет форматирование только в том случае, если условие применяется.
ProcessOutputLine	Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности.
TagList	Представляет список тегов, к которым можно получить доступ по индексу. Предоставляет методы для поиска, сортировки и управления списками.
TagList.Enumerator	Перечислитель для обхода коллекции списков тегов.

Интерфейсы

Имя	Описание
ICollectData	Подготавливает данные о производительности для библиотеки DLL производительности, загружаемой системой при работе с счетчиками производительности.

Перечисления

Имя	Описание
ActivityIdFormat	Задает формат свойства Id.
ActivityKind	Описывает связь между действием, его родителями и дочерними элементами в трассировке.
ActivitySamplingResult	Значения перечисления, используемые ActivityListener для указания объема данных для сбора связанных Activity. Запрос дополнительных данных приводит к повышению производительности.
ActivityStatusCode	Определите код состояния действия, указывающий состояние инструментированных операций.
ActivityTraceFlags	Задает флаги, определенные стандартом W3C, связанным с действием.
DebuggableAttribute.DebuggingModes	Задает режим отладки для JIT-компилятора.
DebuggerBrowsableState	Содержит инструкции по отображению отладчика.
EventLogEntryType	Указывает тип события записи журнала событий.
EventLogPermissionAccess	Определяет уровни доступа, используемые классами разрешений EventLog.
OverflowAction	Указывает, как обрабатывать записи в журнале событий, который достиг максимального размера файла.
PerformanceCounterCategoryType	Указывает, может ли категория счетчика производительности иметь несколько экземпляров.
PerformanceCounterInstanceLifetime	Указывает время существования экземпляра счетчика производительности.
PerformanceCounterPermissionAccess	Определяет уровни доступа, используемые классами разрешений PerformanceCounter.
PerformanceCounterType	Задает типы счетчиков производительности, которые сопоставляют непосредственно с собственными типами.
PresentationTraceLevel	Описывает уровень детализации для трассировки конкретного объекта.
ProcessPriorityClass	Указывает приоритет, связанный системой с процессом. Это значение вместе со значением приоритета каждого потока процесса определяет базовый уровень приоритета каждого потока.
ProcessWindowStyle	Указывает, как должно отображаться новое окно при запуске системы процесса.
SourceLevels	Задает уровни сообщений трассировки, отфильтрованные по исходному коммутатору и фильтру типов событий.
ThreadPriorityLevel	Указывает уровень приоритета потока.
ThreadState	Указывает текущее состояние выполнения потока.
ThreadWaitReason	Указывает причину ожидания потока.
TraceEventType	Определяет тип события, вызвавшего трассировку.
TraceLevel	Указывает, какие сообщения следует выводить для классов Debug, Trace и TraceSwitch.
TraceLogRetentionOption	Указывает структуру файлов, которая будет использоваться для журнала EventSchemaTraceListener.
TraceOptions	Указывает параметры данных трассировки для записи в выходные данные трассировки.

Делегаты

Имя	Описание
DataReceivedEventHandler	Представляет метод, который будет обрабатывать OutputDataReceived событие или ErrorDataReceived событие объекта Process.
DistributedContextPropagator.PropagatorGetterCallback	Представляет метод обратного вызова, используемый в методах извлечения распространителей. Обратный вызов вызывается для поиска значения именованного поля.
DistributedContextPropagator.PropagatorSetterCallback	Представляет метод обратного вызова, используемый в методах внедрения распространения. Этот обратный вызов вызывается для задания значения именованного поля. Распространители могут вызывать его несколько раз, чтобы задать несколько полей.
EntryWrittenEventHandler	Представляет метод, который будет обрабатывать EntryWritten событие объекта EventLog.
ExceptionRecorder	Определяет обратный вызов, используемый для ActivityListener получения уведомлений при добавлении исключений в объект Activity.
SampleActivity<T>	Делегат, определяющий ActivityListener подпись обратных вызовов, используемых в процессе выборки.

Компонент EventLog предоставляет функциональные возможности для записи в журналы событий, чтения записей журнала событий и создания и удаления журналов событий и источников событий в сети. Предоставляет EntryWrittenEventHandler способ асинхронного взаимодействия с журналами событий. Вспомогательные классы предоставляют доступ к более детальному управлению, включая ограничения разрешений, возможность указывать типы журналов событий (которые управляют типом данных по умолчанию, записываемым с помощью записи в журнале событий), а также выполнять итерацию по коллекциям записей журнала событий. Дополнительные сведения об этих задачах смEventLogPermission. в разделе и EventLogEntryType EventLogEntryCollection классах.
Класс Process предоставляет функциональные возможности для мониторинга системных процессов в сети, а также для запуска и остановки локальных системных процессов. Помимо получения списков выполняемых процессов (указав компьютер, имя процесса или идентификатор процесса) или просмотр сведений о процессе, который в настоящее время имеет доступ к обработчику, можно получить подробные сведения о потоках процесса и модулях как через Process сам класс, так и взаимодействие с ProcessThread ProcessModule ними. Класс ProcessStartInfo позволяет указать различные элементы, с помощью которых можно запустить новый процесс, например входные, выходные и потоки ошибок, рабочие каталоги и команды командной строки и аргументы. Они позволяют точно управлять поведением процессов. Другие связанные классы позволяют задавать стили окон, определять приоритеты процессов и потоков, а также взаимодействовать с коллекциями потоков и модулей.
Класс PerformanceCounter позволяет отслеживать производительность системы, а PerformanceCounterCategory класс предоставляет способ создания новых пользовательских счетчиков и категорий. Вы можете записывать данные в локальные настраиваемые счетчики и считывать данные как из локальных, так и из удаленных счетчиков (системных и настраиваемых). Вы можете примеры счетчиков с помощью PerformanceCounter класса и вычислить результаты из последовательных примеров счетчиков производительности с помощью CounterSample класса. Класс CounterCreationData позволяет создавать несколько счетчиков в категории и указывать их типы. Другие классы, связанные с компонентом счетчика производительности, предоставляют доступ к коллекциям счетчиков, разрешениям счетчиков и типам счетчиков.

Пространство System.Diagnostics имен также предоставляет классы, позволяющие отлаживать приложение и отслеживать выполнение кода. Для получения дополнительной информации см. классы Trace и Debug.

Обратная связь

Были ли сведения на этой странице полезными?