Activity Klasa

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.DiagnosticSource.dll

Pakiet:

System.Diagnostics.DiagnosticSource v9.0.0-rc.2.24473.5

Źródło:

Activity.cs

Reprezentuje operację z kontekstem do użycia na potrzeby rejestrowania.

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Dziedziczenie

Object

Activity

Implementuje

IDisposable

Uwagi

Obiekt Activity ma nazwę operacji, identyfikator, godzinę rozpoczęcia i czas trwania, tagi i bagaż.

Dostęp do bieżącego działania można uzyskać za pomocą właściwości statycznej Activity.Current .

Działania powinny być tworzone przez wywołanie konstruktora, skonfigurowanego w razie potrzeby, a następnie rozpoczęcie od Start metody , która utrzymuje relacje nadrzędny-podrzędny dla działań i ustawia wartość Activity.Current.

Po zakończeniu działania należy go zatrzymać za pomocą Activity.Stop() metody .

Jednak jeśli obiekt zostanie Activity usunięty, spowoduje to zatrzymanie go, aby nie trzeba było jawnie wywoływać metody Activity.Stop(). Upraszcza to wzorzec kodowania. Aby uzyskać więcej informacji, zobacz metodę Dispose .

Żadne metody nie Activity zezwalają na ucieczkę wyjątków jako odpowiedź na nieprawidłowe dane wejściowe. Są one zgłaszane i przechwytywane (co umożliwia debugerom i monitorom wyświetlanie błędu), ale wyjątek jest pomijany, a operacja wykonuje coś uzasadnionego (zazwyczaj nic nie robi).

Konstruktory

Activity(String)

Inicjuje nowe wystąpienie klasy Activity.

Właściwości

ActivityTraceFlags	Pobiera lub ustawia flagi (zdefiniowane przez specyfikację identyfikatora W3C) skojarzone z działaniem.
Baggage	Pobiera kolekcję par klucz/wartość, która reprezentuje informacje przekazywane do elementów podrzędnych tego Activityelementu .
Context	Pobiera kontekst działania. Kontekst staje się prawidłowy tylko wtedy, gdy działanie zostało uruchomione.
Current	Pobiera lub ustawia bieżącą operację (Activity) dla bieżącego wątku. Przepływy w wywołaniach asynchronicznych.
DefaultIdFormat	Pobiera lub ustawia domyślny format identyfikatora dla elementu Activity.
DisplayName	Pobiera lub ustawia nazwę wyświetlaną działania.
Duration	Pobiera czas trwania operacji.
Events	Pobiera listę wszystkich zdarzeń działań dołączonych do tego działania.
ForceDefaultIdFormat	Pobiera lub ustawia wartość, która detrmines, jeśli DefaultIdFormat parametr jest zawsze używany do definiowania domyślnego formatu identyfikatora.
HasRemoteParent	Pobiera wartość wskazującą, czy kontekst nadrzędny został utworzony na podstawie propagacji zdalnej.
Id	Pobiera identyfikator specyficzny dla określonego żądania.
IdFormat	Pobiera format dla .Id
IsAllDataRequested	Pobiera lub ustawia wartość wskazującą, czy to działanie powinno zostać wypełnione wszystkimi informacjami propagacji, a także wszystkimi innymi właściwościami, takimi jak linki, tagi i zdarzenia.
IsStopped	Pobiera wartość wskazującą, czy ten Activity obiekt jest zatrzymany, czy nie.
Kind	Pobiera relację między działaniem, rodzicami i dziećmi w śladzie.
Links	Pobiera listę wszystkich łączy działań dołączonych do tego działania.
OperationName	Pobiera nazwę operacji.
Parent	Pobiera element nadrzędny Activity , który utworzył to działanie.
ParentId	Pobiera identyfikator elementu nadrzędnego tego działania.
ParentSpanId	Pobiera element SpanIdnadrzędny .
Recorded	Pobiera wartość wskazującą, czy ustawiono flagę W3CIdFlags.Recorded.
RootId	Pobiera identyfikator główny tego Activityelementu .
Source	Pobiera źródło działania skojarzone z tym działaniem.
SpanId	Pobiera część SPAN elementu Id.
StartTimeUtc	Pobiera czas rozpoczęcia operacji.
Status	Pobiera kod stanu bieżącego obiektu działania.
StatusDescription	Pobiera opis stanu bieżącego obiektu działania.
TagObjects	Pobiera listę tagów reprezentujących informacje do rejestrowania wraz z działaniem. Te informacje nie są przekazywane do elementów podrzędnych tego działania.
Tags	Pobiera kolekcję par klucz/wartość, które reprezentują informacje, które zostaną zarejestrowane wraz z Activity systemem rejestrowania.
TraceId	Pobiera część TraceId elementu Id.
TraceIdGenerator	Podczas uruchamiania działania, które nie ma kontekstu nadrzędnego, identyfikator śledzenia zostanie wygenerowany automatycznie przy użyciu liczb losowych. Funkcji TraceIdGenerator można użyć do zastąpienia domyślnego algorytmu generowania identyfikatora śledzenia środowiska uruchomieniowego.
TraceStateString	Pobiera lub ustawia nagłówek W3C tracestate .

Metody

AddBaggage(String, String)	Aktualizacje, Activity aby mieć nowy przedmiot bagażu z określonym kluczem i wartością.
AddEvent(ActivityEvent)	Dodaje określone zdarzenie działania do listy zdarzeń.
AddException(Exception, TagList, DateTimeOffset)	Reprezentuje operację z kontekstem do użycia na potrzeby rejestrowania.
AddLink(ActivityLink)	Reprezentuje operację z kontekstem do użycia na potrzeby rejestrowania.
AddTag(String, Object)	Aktualizacje działanie, aby mieć tag z dodatkowym key i value.
AddTag(String, String)	Aktualizacje element , Activity aby mieć nowy tag z podanymi key elementami i value.
Dispose()	Zatrzymuje działanie, jeśli zostało już uruchomione i powiadamia o wszelkich odbiornikach zdarzeń. Nic się nie stanie w przeciwnym razie.
Dispose(Boolean)	Po zastąpieniu przez typ pochodny ta metoda zwalnia wszystkie przydzielone zasoby.
EnumerateEvents()	ActivityEvent Wylicza obiekty dołączone do tego obiektu Działania.
EnumerateLinks()	ActivityLink Wylicza obiekty dołączone do tego obiektu Działania.
EnumerateTagObjects()	Wylicza tagi dołączone do tego obiektu Działania.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetBaggageItem(String)	Zwraca wartość pary klucz-wartość dodaną do działania za pomocą polecenia AddBaggage(String, String).
GetCustomProperty(String)	Zwraca obiekt zamapowany na określoną nazwę właściwości.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetTagItem(String)	Zwraca wartość tagu Activity zamapowanego na klucz wejściowy. Zwraca wartość null , jeśli ten klucz nie istnieje.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
SetBaggage(String, String)	Dodaj lub zaktualizuj bagaż aktywności przy użyciu klucza wejściowego i wartości. Jeśli wartość wejściowa to null - jeśli kolekcja ma jakikolwiek bagaż z tym samym kluczem, bagaż ten zostanie usunięty z kolekcji. — w przeciwnym razie nic się nie stanie, a kolekcja nie ulegnie zmianie. Jeśli wartość wejściowa nie null jest — jeśli kolekcja ma bagaż z tym samym kluczem, wartość zamapowana na ten klucz zostanie zaktualizowana przy użyciu nowej wartości wejściowej. - w przeciwnym razie klucz i wartość zostaną dodane jako nowy bagaż do kolekcji. Przedmiot bagażu zostanie zaktualizowany/usunięty tylko wtedy, gdy został on pierwotnie dodany do bieżącej działalności. Przedmioty odziedziczone po rodzicach nie zostaną zmienione/usunięte, zamiast tego nowy przedmiot zostanie dodany do bieżącego bagażu aktywności.
SetCustomProperty(String, Object)	Dołącza dowolny obiekt niestandardowy do tego działania. Jeśli określony propertyName został wcześniej skojarzony z innym obiektem, właściwość zostanie zaktualizowana tak, aby została skojarzona z nowym propertyValue . Zaleca się użycie unikatowej nazwy właściwości, aby uniknąć konfliktów z każdą osobami używającymi tej samej wartości.
SetEndTime(DateTime)	Activity Aktualizacje , aby ustawić wartość jako Duration różnicę między StartTimeUtc i określonym czasem zatrzymania.
SetIdFormat(ActivityIdFormat)	Ustawia format identyfikatora na tym Activity przed rozpoczęciem.
SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)	Ustawia identyfikator nadrzędny przy użyciu konwencji W3C TraceId i SpanId.
SetParentId(String)	Aktualizacje toActivity, aby wskazać, że Activity element o identyfikatorze parentId spowodował ten element Activity.
SetStartTime(DateTime)	Ustawia godzinę rozpoczęcia tego Activityobiektu .
SetStatus(ActivityStatusCode, String)	Ustawia kod stanu i opis bieżącego obiektu działania.
SetTag(String, Object)	Dodaje lub aktualizuje tag działania przy użyciu klucza wejściowego i wartości.
Start()	Uruchamia działanie.
Stop()	Zatrzymuje działanie.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

CurrentChanged

Występuje, gdy Current wartość się zmienia.