Activity Classe

Definição

Namespace:

System.Diagnostics

Assembly:

System.Diagnostics.DiagnosticSource.dll

Origem:

Activity.cs

Representa uma operação com contexto a ser usada para registro em log.

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Herança

Object

Activity

Implementações

IDisposable

Comentários

Um Activity tem um nome de operação, uma ID, uma hora de início e duração, marcas e bagagem.

A atividade atual pode ser acessada com a propriedade estática Activity.Current .

As atividades devem ser criadas chamando o construtor, configuradas conforme necessário e, em seguida, iniciadas com o Start método , que mantém relações pai-filho para as atividades e define Activity.Current.

Quando uma atividade for concluída, ela deverá ser interrompida com o Activity.Stop() método .

No entanto, se você descartar o objeto , isso o Activity interromperá para que você não precise chamar Activity.Stop()explicitamente . Isso simplifica o padrão de codificação. Para obter mais informações, consulte o método Dispose.

Nenhum Activity método permite que exceções escapem como uma resposta a entradas incorretas. Eles são lançados e capturados (o que permite que depuradores e monitores vejam o erro), mas a exceção é suprimida e a operação faz algo razoável (normalmente não faz nada).

Construtores

Activity(String)

Inicializa uma nova instância da classe Activity.

Propriedades

ActivityTraceFlags	Obtém ou define os sinalizadores (definidos pela especificação ID W3C) associados à atividade.
Baggage	Obtém uma coleção de pares chave/valor que representa as informações que são passadas para os filhos deste Activity.
Context	Obtém o contexto da atividade. O contexto se tornará válido somente se a atividade tiver sido iniciada.
Current	Obtém ou define a operação atual (Activity) do thread atual. Isso flui entre as chamadas assíncronas.
DefaultIdFormat	Obtém ou define o formato da ID padrão para o Activity.
DisplayName	Obtém ou define o nome de exibição da atividade.
Duration	Obtém a duração da operação.
Events	Obtém a lista de todos os eventos anexados à atividade.
ForceDefaultIdFormat	Obtém ou define um valor que determina se DefaultIdFormat é sempre usado para definir o formato da ID padrão.
HasRemoteParent	Obtém um valor que indica se o contexto pai foi criado a partir da propagação remota.
Id	Obtém um identificador que é específico para uma determinada solicitação.
IdFormat	Obtém o formato do Id.
IsAllDataRequested	Obtém ou define um valor que indica se a atividade deveria ser preenchida com todas as informações de propagação, assim como outras propriedades, como links, marcas e eventos.
IsStopped	Obtém um valor que indica se esse Activity objeto está parado ou não.
Kind	Obtém a relação entre a atividade, seus pais e seus filhos em um rastreamento.
Links	Obtém a lista de todos os links de atividade anexados à atividade.
OperationName	Obtém o nome da operação.
Parent	Obtém o Activity pai que criou essa atividade.
ParentId	Obtém a ID do pai dessa atividade.
ParentSpanId	Obtém o SpanId do pai.
Recorded	Obtém um valor que indica se o sinalizador W3CIdFlags.Recorded foi definido.
RootId	Obtém a ID de raiz deste Activity.
Source	Obtém a origem de atividade associada a essa atividade.
SpanId	Obtém a parte SPAN do Id.
StartTimeUtc	Obtém a hora de quando a operação foi iniciada.
Status	Obtém status código do objeto de atividade atual.
StatusDescription	Obtém a descrição status do objeto de atividade atual.
TagObjects	Obtém a lista de marcas que representam informações para serem registradas junto à atividade. Essas informações não são passadas para os filhos da atividade.
Tags	Obtém uma coleção de pares chave/valor que representam informações que serão registradas com o Activity no sistema de registro em log.
TraceId	Obtém a parte TraceId do Id.
TraceIdGenerator	Ao iniciar uma Atividade que não tem um contexto pai, a ID de Rastreamento será gerada automaticamente usando números aleatórios. TraceIdGenerator pode ser usado para substituir o algoritmo de geração de ID de rastreamento padrão do runtime.
TraceStateString	Obtém ou define o cabeçalho tracestate W3C.

Métodos

AddBaggage(String, String)	Atualiza Activity para ter um novo item de bagagem com a chave e o valor especificados.
AddEvent(ActivityEvent)	Adiciona o evento da atividade especificado à lista de eventos.
AddException(Exception, TagList, DateTimeOffset)	Representa uma operação com contexto a ser usada para registro em log.
AddLink(ActivityLink)	Representa uma operação com contexto a ser usada para registro em log.
AddTag(String, Object)	Atualiza a atividade para ter uma marcação com key e value adicionais.
AddTag(String, String)	Atualiza Activity para ter uma nova marcação com os key e value fornecidos.
Dispose()	Interromperá a atividade se ela já tiver sido iniciada e notificará os ouvintes do evento. Caso contrário, nada acontecerá.
Dispose(Boolean)	Quando for substituído por um tipo derivado, esse método liberará todos os recursos alocados.
EnumerateEvents()	Enumera os ActivityEvent objetos anexados a este objeto Activity.
EnumerateLinks()	Enumera os ActivityLink objetos anexados a este objeto Activity.
EnumerateTagObjects()	Enumera as marcas anexadas a este objeto Activity.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetBaggageItem(String)	Retorna o valor de um par chave-valor adicionado para a atividade com AddBaggage(String, String).
GetCustomProperty(String)	Retorna o objeto mapeado para o nome de propriedade especificado.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetTagItem(String)	Retorna o valor da marca Atividade mapeada para a chave de entrada. Retornará null se essa chave não existir.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
SetBaggage(String, String)	Adicione ou atualize a bagagem de atividade com a chave de entrada e o valor. Se o valor de entrada for null - se a coleção tiver alguma bagagem com a mesma chave, essa bagagem será removida da coleção. – caso contrário, nada acontecerá e a coleção não será alterada. Se o valor de entrada não null for - se a coleção tiver qualquer bagagem com a mesma chave, o valor mapeado para essa chave será atualizado com o novo valor de entrada. – caso contrário, a chave e o valor serão adicionados como uma nova bagagem à coleção. O item de bagagem será atualizado/removido somente se ele tiver sido originalmente adicionado à atividade atual. Os itens herdados dos pais não serão alterados/removidos, o novo item será adicionado à bagagem de atividade atual.
SetCustomProperty(String, Object)	Anexa qualquer objeto personalizado à atividade. Se o propertyName especificado tiver sido associado anteriormente a outro objeto, a propriedade será atualizada para ser associada ao novo propertyValue. É recomendável usar um nome de propriedade exclusivo para evitar conflitos com qualquer pessoa que use o mesmo valor.
SetEndTime(DateTime)	Atualiza Activity para definir Duration como a diferença entre StartTimeUtc e a hora de término especificada.
SetIdFormat(ActivityIdFormat)	Define o formato da ID neste Activity antes que seja iniciado.
SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)	Define a ID pai usando a convenção W3C de um TraceId e um SpanId.
SetParentId(String)	Atualiza este Activity para indicar que o Activity com uma ID parentId causou este Activity.
SetStartTime(DateTime)	Define a hora de início deste Activity.
SetStatus(ActivityStatusCode, String)	Define o código status e a descrição no objeto de atividade atual.
SetTag(String, Object)	Adiciona ou atualiza a marcação de atividade com a chave de entrada e o valor.
Start()	Inicia a atividade.
Stop()	Interrompe a atividade.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

CurrentChanged

Ocorre quando o valor Current é alterado.