System.Diagnostics Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности.
Классы
| Activity |
Представляет операцию с контекстом для ведения журнала. |
| ActivityListener |
Позволяет прослушивать события начала и остановки действий и дает возможность решить создание действия для сценариев выборки. |
| ActivitySource |
Предоставляет API для создания и запуска объектов Activity и регистрации ActivityListener объектов для прослушивания событий Activity. |
| ActivitySourceOptions |
Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности. |
| ActivityTagsCollection |
ActivityTagsCollection — это класс коллекции, используемый для хранения тегов трассировки. Эта коллекция будет использоваться с такими классами, как ActivityEvent и ActivityLink. Эта коллекция ведет себя следующим образом:
|
| 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 |
Представляет компонент счетчика производительности Windows NT. |
| PerformanceCounterCategory |
Представляет объект производительности, определяющий категорию счетчиков производительности. |
| PerformanceCounterInstaller |
Указывает установщик для компонента PerformanceCounter. |
| PerformanceCounterManager |
Подготавливает данные о производительности для performance.dll системе загружается при работе с счетчиками производительности. |
| PerformanceCounterPermission |
Разрешает управление разрешениями доступа к коду для PerformanceCounter. |
| PerformanceCounterPermissionAttribute |
Разрешает декларативные проверки разрешений счетчика производительности. |
| PerformanceCounterPermissionEntry |
Определяет наименьшую единицу разрешения на доступ к коду, заданного для PerformanceCounter. |
| PerformanceCounterPermissionEntryCollection |
Содержит строго типизированную коллекцию объектов PerformanceCounterPermissionEntry. |
| PresentationTraceSources |
Предоставляет поддержку трассировки отладки, предназначенную специально для приложений Windows Presentation Foundation (WPF). |
| Process |
Предоставляет доступ к локальным и удаленным процессам и позволяет запускать и останавливать локальные системные процессы. |
| ProcessModule |
Представляет файл .dll или .exe, загруженный в определенный процесс. |
| ProcessModuleCollection |
Предоставляет строго типизированную коллекцию объектов ProcessModule. |
| ProcessStartInfo |
Задает набор значений, используемых при запуске процесса. |
| 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 |
Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности. |
| TraceEventCache |
Предоставляет данные события трассировки, относящиеся к потоку и процессу. |
| TraceFilter |
Предоставляет базовый класс для реализации фильтров трассировки. |
| TraceListener |
Предоставляет базовый класс |
| 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 |
Перечисляет элементы |
| ActivityTraceId |
Представляет TraceId, формат которого основан на стандарте W3C. |
| CounterSample |
Определяет структуру, содержащую необработанные данные для счетчика производительности. |
| Debug.AssertInterpolatedStringHandler |
Предоставляет интерполированный обработчик строки для Assert(Boolean), который выполняет форматирование только в случае сбоя утверждения. |
| Debug.WriteIfInterpolatedStringHandler |
Предоставляет интерполированный обработчик строк для WriteIf(Boolean, String) и WriteLineIf(Boolean, Object), который выполняет форматирование только в том случае, если условие применяется. |
| 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 или событие ErrorDataReceivedProcess. |
| DistributedContextPropagator.PropagatorGetterCallback |
Представляет метод обратного вызова, используемый в методах извлечения распространителей. Обратный вызов вызывается для поиска значения именованного поля. |
| DistributedContextPropagator.PropagatorSetterCallback |
Представляет метод обратного вызова, используемый в методах внедрения распространения. Этот обратный вызов вызывается для задания значения именованного поля. Распространители могут вызывать его несколько раз, чтобы задать несколько полей. |
| EntryWrittenEventHandler |
Представляет метод, который будет обрабатывать событие EntryWrittenEventLog. |
| ExceptionRecorder |
Предоставляет классы, позволяющие взаимодействовать с системными процессами, журналами событий и счетчиками производительности. |
| SampleActivity<T> |
Делегат, определяющий сигнатуру обратных вызовов ActivityListener, используемых в процессе выборки. |
Комментарии
Компонент EventLog предоставляет функциональные возможности для записи в журналы событий, чтения записей журнала событий и создания журналов событий и удаления журналов событий и источников событий в сети. EntryWrittenEventHandler предоставляет способ асинхронного взаимодействия с журналами событий. Вспомогательные классы предоставляют доступ к более подробному элементу управления, включая ограничения разрешений, возможность указывать типы журналов событий (которые управляют типом данных по умолчанию, записанным с записью журнала событий), а также выполнять итерацию с помощью коллекций записей журнала событий. Дополнительные сведения об этих задачах см. в EventLogPermission, EventLogEntryTypeи классах EventLogEntryCollection.
Класс Process предоставляет функциональные возможности для мониторинга системных процессов в сети и запуска и остановки локальных системных процессов. Помимо получения списков выполняемых процессов (указав компьютер, имя процесса или идентификатор процесса) или просмотр сведений о процессе, который в настоящее время имеет доступ к обработчику, можно получить подробные сведения о потоках процессах и модулях как через сам класс Process, так и взаимодействие с ProcessThread и ProcessModule классами. Класс ProcessStartInfo позволяет указать различные элементы, с помощью которых можно запустить новый процесс, например входные, выходные и потоки ошибок, рабочие каталоги и команды командной строки и аргументы. Они обеспечивают точное управление поведением процессов. Другие связанные классы позволяют указывать стили окон, приоритеты процессов и потоков, а также взаимодействовать с коллекциями потоков и модулей.
Класс PerformanceCounter позволяет отслеживать производительность системы, а класс PerformanceCounterCategory предоставляет способ создания новых пользовательских счетчиков и категорий. Вы можете записывать в локальные настраиваемые счетчики и читать их как из локальных, так и из удаленных счетчиков (система, а также пользовательская). Вы можете примеры счетчиков с помощью класса PerformanceCounter и вычислить результаты из последовательных примеров счетчиков производительности с помощью класса CounterSample. Класс CounterCreationData позволяет создавать несколько счетчиков в категории и указывать их типы. Другие классы, связанные с компонентом счетчика производительности, предоставляют доступ к коллекциям счетчиков, разрешений счетчиков и типов счетчиков.
Пространство имен System.Diagnostics также предоставляет классы, позволяющие отлаживать приложение и отслеживать выполнение кода. Дополнительные сведения см. в Trace и классах Debug.