Partilhar via


Activity Classe

Definição

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

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
Herança
Activity
Implementações

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.

Aplica-se a