System.Diagnostics Przestrzeń nazw
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Udostępnia klasy, które umożliwiają interakcję z procesami systemowych, dziennikami zdarzeń i licznikami wydajności.
Klasy
| Activity |
Reprezentuje operację z kontekstem używanym do rejestrowania. |
| ActivityListener |
Umożliwia nasłuchiwanie zdarzeń uruchamiania i zatrzymywania działań oraz umożliwia podjęcie decyzji o utworzeniu działania na potrzeby scenariuszy próbkowania. |
| ActivitySource |
Udostępnia interfejsy API do tworzenia i uruchamiania Activity obiektów oraz rejestrowania ActivityListener obiektów w celu nasłuchiwania zdarzeń Activity . |
| ActivityTagsCollection |
ActivityTagsCollection to klasa kolekcji używana do przechowywania tagów śledzenia. Ta kolekcja będzie używana z klasami takimi jak ActivityEvent i ActivityLink. Ta kolekcja zachowuje się w następujący sposób: — Elementy kolekcji będą uporządkowane zgodnie z sposobem ich dodawania. — Nie zezwalaj na duplikowanie elementów z tym samym kluczem.
|
| BooleanSwitch |
Zapewnia prosty przełącznik włączony/wyłączony, który kontroluje debugowanie i śledzenie danych wyjściowych. |
| ConditionalAttribute |
Wskazuje kompilatory, że wywołanie metody lub atrybut powinny być ignorowane, chyba że zdefiniowano określony symbol kompilacji warunkowej. |
| ConsoleTraceListener |
Kieruje śledzenie lub debugowanie danych wyjściowych do standardowych danych wyjściowych lub standardowego strumienia błędów. |
| CorrelationManager |
Koreluje ślady będące częścią transakcji logicznej. |
| CounterCreationData |
Definiuje typ licznika, nazwę i ciąg Pomocy dla licznika niestandardowego. |
| CounterCreationDataCollection |
Udostępnia silnie typizowane kolekcje CounterCreationData obiektów. |
| CounterSampleCalculator |
Udostępnia zestaw funkcji narzędzi do interpretowania danych licznika wydajności. |
| DataReceivedEventArgs |
Dostarcza dane dla zdarzeń OutputDataReceived i ErrorDataReceived . |
| Debug |
Zawiera zestaw metod i właściwości, które ułatwiają debugowanie kodu. |
| DebuggableAttribute |
Modyfikuje generowanie kodu na potrzeby debugowania just in time (JIT) środowiska uruchomieniowego. Klasa ta nie może być dziedziczona. |
| Debugger |
Umożliwia komunikację z debugerem. Klasa ta nie może być dziedziczona. |
| DebuggerBrowsableAttribute |
Określa, czy element członkowski jest wyświetlany w oknach zmiennych debugera. Klasa ta nie może być dziedziczona. |
| DebuggerDisplayAttribute |
Określa sposób wyświetlania klasy lub pola w oknach zmiennych debugera. |
| DebuggerHiddenAttribute |
Określa .DebuggerHiddenAttribute Klasa ta nie może być dziedziczona. |
| DebuggerNonUserCodeAttribute |
Identyfikuje typ lub element członkowski, który nie jest częścią kodu użytkownika dla aplikacji. |
| DebuggerStepperBoundaryAttribute |
Wskazuje kod po atrybucie, który ma zostać wykonany w przebiegu, a nie w trybie kroku. |
| DebuggerStepThroughAttribute |
Instruuje debugera, aby przechodził przez kod zamiast przechodzić do kodu. Klasa ta nie może być dziedziczona. |
| DebuggerTypeProxyAttribute |
Określa wyświetlany serwer proxy dla typu. |
| DebuggerVisualizerAttribute |
Określa, że typ ma wizualizator. Klasa ta nie może być dziedziczona. |
| DefaultTraceListener |
Udostępnia domyślne metody i zachowanie danych wyjściowych do śledzenia. |
| DelimitedListTraceListener |
Kieruje śledzenie lub debugowanie danych wyjściowych do modułu zapisywania tekstu, takiego jak składnik zapisywania strumienia lub strumienia, takiego jak strumień plików. |
| DiagnosticListener |
Zapewnia implementację klasy abstrakcyjnej DiagnosticSource , która reprezentuje nazwane miejsce, do którego źródło wysyła informacje (zdarzenia). |
| DiagnosticListenerExtensions | |
| DiagnosticsConfigurationHandler |
Obsługuje sekcję diagnostyki plików konfiguracji. |
| DiagnosticSource |
Abstrakcyjna klasa, która umożliwia instrumentację kodu na potrzeby rejestrowania w czasie produkcyjnym bogatych ładunków danych do użycia w ramach instrumentowanego procesu. |
| DistributedContextPropagator |
Implementacja DistributedContextPropagator określa, czy i jak rozproszone informacje kontekstowe są kodowane i dekodowane podczas przechodzenia przez sieć. Kodowanie można transportować za pośrednictwem dowolnego protokołu sieciowego obsługującego pary klucz-wartość ciągu. Na przykład w przypadku korzystania z protokołu HTTP każda para klucz-wartość jest nagłówkiem HTTP. DistributedContextPropagator wprowadza wartości do i wyodrębnia wartości z operatorów jako pary klucz-wartość ciągu. |
| EntryWrittenEventArgs |
Udostępnia dane dla zdarzenia EntryWritten. |
| EventInstance |
Reprezentuje informacje neutralne dla języka dla wpisu dziennika zdarzeń. |
| EventLog |
Zapewnia interakcję z dziennikami zdarzeń Windows. |
| EventLogEntry |
Hermetyzuje pojedynczy rekord w dzienniku zdarzeń. Klasa ta nie może być dziedziczona. |
| EventLogEntryCollection |
Definiuje rozmiar i wyliczacze dla kolekcji EventLogEntry wystąpień. |
| EventLogInstaller |
Umożliwia zainstalowanie i skonfigurowanie dziennika zdarzeń, który aplikacja odczytuje z lub zapisuje podczas uruchamiania. |
| EventLogPermission |
Steruje uprawnieniami dostępu do kodu na potrzeby rejestrowania zdarzeń. |
| EventLogPermissionAttribute |
Umożliwia deklaratywne sprawdzanie uprawnień na potrzeby rejestrowania zdarzeń. |
| EventLogPermissionEntry |
Definiuje najmniejszą jednostkę uprawnienia zabezpieczeń dostępu do kodu ustawionego dla elementu EventLog. |
| EventLogPermissionEntryCollection |
Zawiera silnie typizowane kolekcje EventLogPermissionEntry obiektów. |
| EventLogTraceListener |
Udostępnia prosty odbiornik kierujący dane wyjściowe śledzenia lub debugowania do elementu EventLog. |
| EventSchemaTraceListener |
Kieruje śledzenie lub debugowanie danych wyjściowych zdarzeń end-to-end do pliku dziennika zakodowanego w formacie XML, zgodnego ze schematem. |
| EventSourceCreationData |
Reprezentuje ustawienia konfiguracji używane do tworzenia źródła dziennika zdarzeń na komputerze lokalnym lub komputerze zdalnym. |
| EventTypeFilter |
Wskazuje, czy odbiornik powinien śledzić na podstawie typu zdarzenia. |
| FileVersionInfo |
Zawiera informacje o wersji pliku fizycznego na dysku. |
| InstanceData |
Przechowuje dane wystąpienia skojarzone z przykładem licznika wydajności. |
| InstanceDataCollection |
Zawiera silnie typizowana kolekcja InstanceData obiektów. |
| InstanceDataCollectionCollection |
Udostępnia silnie typizowane kolekcje InstanceDataCollection obiektów. |
| MonitoringDescriptionAttribute |
Określa opis właściwości lub zdarzenia. |
| PerformanceCounter |
Reprezentuje składnik licznika wydajności systemu Windows NT. |
| PerformanceCounterCategory |
Reprezentuje obiekt wydajności, który definiuje kategorię liczników wydajności. |
| PerformanceCounterInstaller |
Określa instalatora składnika PerformanceCounter . |
| PerformanceCounterManager |
Przygotowuje dane wydajności dla performance.dll obciążenia systemu podczas pracy z licznikami wydajności. |
| PerformanceCounterPermission |
Umożliwia kontrolę uprawnień dostępu do kodu dla programu PerformanceCounter. |
| PerformanceCounterPermissionAttribute |
Umożliwia deklaratywne sprawdzanie uprawnień licznika wydajności. |
| PerformanceCounterPermissionEntry |
Definiuje najmniejszą jednostkę uprawnienia zabezpieczeń dostępu do kodu ustawionego dla elementu PerformanceCounter. |
| PerformanceCounterPermissionEntryCollection |
Zawiera silnie typizowana kolekcja PerformanceCounterPermissionEntry obiektów. |
| PresentationTraceSources |
Zapewnia obsługę śledzenia debugowania, która jest przeznaczona specjalnie dla aplikacji Windows Presentation Foundation (WPF). |
| Process |
Zapewnia dostęp do procesów lokalnych i zdalnych oraz umożliwia uruchamianie i zatrzymywanie procesów systemu lokalnego. |
| ProcessModule |
Reprezentuje plik a.dll lub .exe ładowany do określonego procesu. |
| ProcessModuleCollection |
Udostępnia silnie typizowane kolekcje ProcessModule obiektów. |
| ProcessStartInfo |
Określa zestaw wartości używanych podczas uruchamiania procesu. |
| ProcessThread |
Reprezentuje wątek procesu systemu operacyjnego. |
| ProcessThreadCollection |
Zawiera silnie typizowana kolekcja ProcessThread obiektów. |
| SourceFilter |
Wskazuje, czy odbiornik powinien śledzić komunikat na podstawie źródła śledzenia. |
| SourceSwitch |
Zapewnia przełącznik wieloszczepowy do sterowania śledzeniem i debugowaniem danych wyjściowych bez ponownego komplikowania kodu. |
| StackFrame |
Zawiera informacje o obiekcie StackFrame, który reprezentuje wywołanie funkcji w stosie wywołań dla bieżącego wątku. |
| StackFrameExtensions |
Udostępnia metody rozszerzenia dla StackFrame klasy, która reprezentuje wywołanie funkcji w stosie wywołań dla bieżącego wątku. |
| StackTrace |
Reprezentuje ślad stosu, który jest uporządkowaną kolekcją jednej lub kilku ramek stosu. |
| StackTraceHiddenAttribute |
Typy i metody przypisane stackTraceHidden zostaną pominięte z tekstu śledzenia stosu pokazanego w elemecie StackTrace.ToString() i Exception.StackTrace |
| Stopwatch |
Zawiera zestaw metod i właściwości, których można użyć do dokładnego mierzenia czasu, który upłynął. |
| Switch |
Udostępnia abstrakcyjną klasę bazową do tworzenia nowych przełączników debugowania i śledzenia. |
| SwitchAttribute |
Identyfikuje przełącznik używany w zestawie, klasie lub składowej. |
| SwitchLevelAttribute |
Określa typ poziomu przełącznika. |
| TextWriterTraceListener |
Kieruje śledzenie lub debugowanie danych wyjściowych do elementu TextWriter lub do Streamelementu , takiego jak FileStream. |
| Trace |
Zawiera zestaw metod i właściwości, które ułatwiają śledzenie wykonywania kodu. Klasa ta nie może być dziedziczona. |
| TraceEventCache |
Dostarcza dane zdarzenia śledzenia specyficzne dla wątku i procesu. |
| TraceFilter |
Udostępnia klasę bazową dla implementacji filtru śledzenia. |
| TraceListener |
Udostępnia klasę bazową |
| TraceListenerCollection |
Udostępnia bezpieczną wątkowo listę TraceListener obiektów. |
| TraceSource |
Udostępnia zestaw metod i właściwości, które umożliwiają aplikacjom śledzenie wykonywania kodu i kojarzenie komunikatów śledzenia ze źródłem. |
| TraceSwitch |
Zapewnia przełącznik wielopowiaskowy do śledzenia sterowania i debugowania danych wyjściowych bez ponownego komplikowania kodu. |
| UnescapedXmlDiagnosticData |
Udostępnia niewyobrażalne dane XML na potrzeby rejestrowania danych śledzenia dostarczonych przez użytkownika. |
| UnreachableException |
Wyjątek, który jest zgłaszany, gdy program wykonuje instrukcję, która była uważana za niemożliwą do osiągnięcia. |
| XmlWriterTraceListener |
Kieruje śledzenie lub debugowanie danych wyjściowych jako dane zakodowane w formacie XML do obiektu TextWriter lub do Streamobiektu , takiego jak FileStream. |
Struktury
| Activity.Enumerator<T> |
Wylicza dane przechowywane w Activity obiekcie. |
| ActivityChangedEventArgs |
Udostępnia dane dla zdarzenia CurrentChanged. |
| ActivityContext |
Reprezentacja zgodna ze specyfikacją TraceContext W3C. Zawiera dwa identyfikatory: TraceId i SpanId wraz z zestawem typowych wartości TraceFlags i tracestate specyficznych dla systemu. |
| ActivityCreationOptions<T> |
Hermetyzuje wszystkie informacje wysyłane do odbiornika działań, aby podejmować decyzje dotyczące tworzenia wystąpienia działania, a także jego stanu. Możliwe parametry typu ogólnego to ActivityContext lub String. |
| ActivityEvent |
Reprezentuje zdarzenie zawierające nazwę i znacznik czasu, a także opcjonalną listę tagów. |
| ActivityLink |
Działania mogą być połączone z zerem lub większą liczbie wystąpień kontekstu działania, które są związane przyczynowo. Linki działań mogą wskazywać konteksty działań wewnątrz pojedynczego śledzenia lub w różnych śladach. Linki działań mogą służyć do reprezentowania operacji wsadowych, w których działanie zostało zainicjowane przez wiele działań inicjujących, z których każdy reprezentuje pojedynczy przychodzący element przetwarzany w partii. |
| ActivitySpanId |
Reprezentuje sformatowany SpanId na podstawie standardu W3C. |
| ActivityTagsCollection.Enumerator |
Wylicza elementy elementu |
| ActivityTraceId |
Reprezentuje format, którego TraceId format jest oparty na standardzie W3C. |
| CounterSample |
Definiuje strukturę, która przechowuje nieprzetworzone dane dla licznika wydajności. |
| Debug.AssertInterpolatedStringHandler |
Udostępnia interpolowaną procedurę obsługi ciągów, Assert(Boolean) która wykonuje formatowanie tylko w przypadku niepowodzenia potwierdzenia. |
| Debug.WriteIfInterpolatedStringHandler |
Udostępnia procedurę obsługi ciągów interpolowanych dla WriteIf(Boolean, String) programu i WriteLineIf(Boolean, Object) wykonuje formatowanie tylko wtedy, gdy warunek ma zastosowanie. |
| TagList |
Reprezentuje listę tagów, do których można uzyskać dostęp za pomocą indeksu. Udostępnia metody wyszukiwania, sortowania i manipulowania listami. |
| TagList.Enumerator |
Moduł wyliczający do przechodzenia przez kolekcję listy tagów. |
Interfejsy
| ICollectData |
Przygotowuje dane wydajności dla biblioteki DLL wydajności ładowane przez system podczas pracy z licznikami wydajności. |
Wyliczenia
| ActivityIdFormat |
Określa format Id właściwości. |
| ActivityKind |
Opisuje relację między działaniem, jego rodzicami i jego dziećmi w śladzie. |
| ActivitySamplingResult |
Wartości wyliczenia używane przez, ActivityListener aby wskazać ilość danych do zebrania dla powiązanego Activityelementu . Żądanie większej ilości danych powoduje większe obciążenie wydajności. |
| ActivityStatusCode |
Zdefiniuj kod stanu działania, który wskazuje stan operacji instrumentowanej. |
| ActivityTraceFlags |
Określa flagi zdefiniowane przez standard W3C, które są skojarzone z działaniem. |
| DebuggableAttribute.DebuggingModes |
Określa tryb debugowania kompilatora just in time (JIT). |
| DebuggerBrowsableState |
Zawiera instrukcje wyświetlania debugera. |
| EventLogEntryType |
Określa typ zdarzenia wpisu dziennika zdarzeń. |
| EventLogPermissionAccess |
Definiuje poziomy dostępu używane przez EventLog klasy uprawnień. |
| OverflowAction |
Określa sposób obsługi wpisów w dzienniku zdarzeń, który osiągnął maksymalny rozmiar pliku. |
| PerformanceCounterCategoryType |
Wskazuje, czy kategoria licznika wydajności może mieć wiele wystąpień. |
| PerformanceCounterInstanceLifetime |
Określa okres istnienia wystąpienia licznika wydajności. |
| PerformanceCounterPermissionAccess |
Definiuje poziomy dostępu używane przez PerformanceCounter klasy uprawnień. |
| PerformanceCounterType |
Określa typy liczników wydajności mapujące bezpośrednio na typy natywne. |
| PresentationTraceLevel |
Opisuje poziom szczegółowości do śledzenia określonego obiektu. |
| ProcessPriorityClass |
Wskazuje priorytet, który system kojarzy z procesem. Ta wartość wraz z wartością priorytetu każdego wątku procesu określa poziom priorytetu każdego wątku. |
| ProcessWindowStyle |
Określono sposób wyświetlania nowego okna podczas uruchamiania procesu przez system. |
| SourceLevels |
Określa poziomy komunikatów śledzenia filtrowanych przez przełącznik źródłowy i filtr typu zdarzenia. |
| ThreadPriorityLevel |
Określa poziom priorytetu wątku. |
| ThreadState |
Określa bieżący stan wykonywania wątku. |
| ThreadWaitReason |
Określa przyczynę oczekiwania wątku. |
| TraceEventType |
Określa typ zdarzenia, które spowodowało ślad. |
| TraceLevel |
Określa, jakie komunikaty mają być wyjściowe dla Debugklas i . Trace TraceSwitch |
| TraceLogRetentionOption |
Określa strukturę plików, która będzie używana w EventSchemaTraceListener dzienniku. |
| TraceOptions |
Określa opcje danych śledzenia, które mają być zapisywane w danych wyjściowych śledzenia. |
Delegaci
| DataReceivedEventHandler |
Reprezentuje metodę, która będzie obsługiwać OutputDataReceived zdarzenie lub ErrorDataReceived zdarzenie obiektu Process. |
| DistributedContextPropagator.PropagatorGetterCallback |
Reprezentuje metodę wywołania zwrotnego używaną w metodach wyodrębniania propagatorów. Wywołanie zwrotne jest wywoływane w celu wyszukania wartości nazwanego pola. |
| DistributedContextPropagator.PropagatorSetterCallback |
Reprezentuje metodę wywołania zwrotnego używaną w metodach iniekcji propagatorów. To wywołanie zwrotne jest wywoływane w celu ustawienia wartości nazwanego pola. Propagatory mogą wywoływać je wiele razy w celu ustawienia wielu pól. |
| EntryWrittenEventHandler |
Reprezentuje metodę, która będzie obsługiwać EntryWritten zdarzenie elementu EventLog. |
| SampleActivity<T> |
Delegat, który definiuje podpis ActivityListener wywołań zwrotnych używanych w procesie próbkowania. |
Uwagi
Składnik udostępnia funkcję zapisu w dziennikach zdarzeń, odczytywania wpisów dziennika zdarzeń oraz tworzenia i usuwania dzienników zdarzeń i źródeł zdarzeń EventLog w sieci. Zapewnia EntryWrittenEventHandler sposób asynchronicznej interakcji z dziennikami zdarzeń. Klasy obsługi zapewniają dostęp do bardziej szczegółowej kontroli, w tym: ograniczeń uprawnień, możliwości określania typów dzienników zdarzeń (które kontrolują typ domyślnych danych zapisywanych z wpisem dziennika zdarzeń) i iterowania po kolekcjach wpisów dziennika zdarzeń. Aby uzyskać więcej informacji na temat tych zadań, zobacz EventLogPermission EventLogEntryType klasy , i EventLogEntryCollection .
Klasa udostępnia funkcje monitorowania procesów systemowych w sieci oraz uruchamiania Process i zatrzymywania lokalnych procesów systemowych. Oprócz pobierania list uruchomionych procesów (przez określenie komputera, nazwy procesu lub identyfikatora procesu) lub wyświetlania informacji o procesie, który obecnie ma dostęp do procesora, można uzyskać szczegółową wiedzę na temat wątków procesów i modułów zarówno za pośrednictwem samej klasy, jak i przez interakcję z Process ProcessThread klasami ProcessModule i . Klasa umożliwia określenie różnych elementów, za pomocą których ma być rozpoczynany nowy proces, takich jak strumienie danych wejściowych, wyjściowych i błędów, katalogi robocze oraz czasowniki i argumenty wiersza ProcessStartInfo polecenia. Zapewniają one precyzyjne kontrolowanie zachowania procesów. Inne powiązane klasy umożliwiają określanie stylów okna, priorytetów procesu i wątku oraz interakcję z kolekcjami wątków i modułów.
Klasa umożliwia monitorowanie wydajności systemu, podczas gdy klasa zapewnia sposób tworzenia nowych niestandardowych PerformanceCounter PerformanceCounterCategory liczników i kategorii. Możesz zapisywać do lokalnych liczników niestandardowych i odczytywać z liczników lokalnych i zdalnych (systemowych i niestandardowych). Można próbkować liczniki przy użyciu klasy i obliczać wyniki z kolejnych próbek PerformanceCounter liczników wydajności przy użyciu klasy CounterSample . Klasa CounterCreationData umożliwia utworzenie wielu liczników w kategorii i określenie ich typów. Inne klasy skojarzone ze składnikiem licznika wydajności zapewniają dostęp do kolekcji liczników, uprawnienia liczników i typów liczników.
Przestrzeń System.Diagnostics nazw udostępnia również klasy, które umożliwiają debugowanie aplikacji i śledzenie wykonywania kodu. Aby uzyskać więcej informacji, zobacz Trace klasy Debug i .