Udostępnij za pośrednictwem


Activity Klasa

Definicja

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

public ref class Activity : IDisposable
public ref class Activity
public class Activity : IDisposable
public class Activity
type Activity = class
    interface IDisposable
type Activity = class
Public Class Activity
Implements IDisposable
Public Class Activity
Dziedziczenie
Activity
Implementuje

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.

Dotyczy