Compartir a través de


Activity Clase

Definición

Representa una operación con el contexto que se usará para el registro.

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
Herencia
Activity
Implementaciones

Comentarios

Tiene Activity un nombre de operación, un identificador, una hora de inicio y una duración, etiquetas y equipaje.

Se puede acceder a la actividad actual con la propiedad estática Activity.Current .

Las actividades deben crearse llamando al constructor, configurado según sea necesario y, a continuación, se inician con el Start método , que mantiene las relaciones de elementos primarios y secundarios para las actividades y establece Activity.Current.

Cuando finalice una actividad, se debe detener con el Activity.Stop() método .

Sin embargo, si elimina el Activity objeto , lo detiene para que no tenga que llamar Activity.Stop()explícitamente a . Esto simplifica el patrón de codificación. Para obtener más información, vea el método Dispose.

Ningún Activity método permite que las excepciones escapen como respuesta a entradas incorrectas. Se inician y detectan (lo que permite a los depuradores y monitores ver el error), pero se suprime la excepción y la operación hace algo razonable (normalmente no hace nada).

Constructores

Activity(String)

Inicializa una nueva instancia de la clase Activity.

Propiedades

ActivityTraceFlags

Obtiene o establece las marcas (definidas por la especificación del id. W3C) asociadas a la actividad.

Baggage

Obtiene una colección de pares clave-valor que representa la información que se pasa a los elementos secundarios de este Activity.

Context

Obtiene el contexto de la actividad. El contexto solo es válido si se ha iniciado la actividad.

Current

Obtiene o establece la operación actual (Activity) del subproceso actual. Fluye a través de llamadas asincrónicas.

DefaultIdFormat

Obtiene o establece el formato del id. predeterminado para el elemento Activity.

DisplayName

Obtiene o establece el nombre para mostrar de la actividad.

Duration

Obtiene la duración de la operación.

Events

Obtiene la lista de todos los eventos de actividad adjuntos a esta actividad.

ForceDefaultIdFormat

Obtiene o establece un valor que determina si el elemento DefaultIdFormat siempre se utiliza para definir el formato del id. predeterminado.

HasRemoteParent

Obtiene un valor que indica si el contexto primario se creó a partir de la propagación remota.

Id

Obtiene un identificador específico de una solicitud determinada.

IdFormat

Obtiene el formato para el elemento Id.

IsAllDataRequested

Obtiene o establece un valor que indica si esta actividad debe rellenarse con toda la información de propagación, así como todas las demás propiedades, como vínculos, etiquetas y eventos.

IsStopped

Obtiene un valor que indica si este Activity objeto está detenido o no.

Kind

Obtiene la relación entre la actividad, sus elementos primarios y sus elementos secundarios en un seguimiento.

Links

Obtiene la lista de todos los vínculos de actividad adjuntos a esta actividad.

OperationName

Obtiene el nombre de la operación.

Parent

Obtiene el elemento primario Activity que ha creado esta actividad.

ParentId

Obtiene el identificador del elemento primario de esta actividad.

ParentSpanId

Obtiene el elemento SpanId del objeto primario.

Recorded

Obtiene un valor que indica si se establece la marca W3CIdFlags.Recorded.

RootId

Obtiene el identificador de raíz de este Activity.

Source

Obtiene el origen de actividad asociado a esta actividad.

SpanId

Obtiene la parte del intervalo del elemento Id.

StartTimeUtc

Obtiene la hora a la que se ha iniciado la operación.

Status

Obtiene el código de estado del objeto de actividad actual.

StatusDescription

Obtiene la descripción del estado del objeto de actividad actual.

TagObjects

Obtiene la lista de etiquetas que representan información que se va a registrar junto con la actividad. Esta información no se pasa a los elementos secundarios de esta actividad.

Tags

Obtiene una colección de pares clave-valor que representa la información que se va a registrar junto con Activity en el sistema de registro.

TraceId

Obtiene la parte de TraceId del elemento Id.

TraceIdGenerator

Al iniciar una actividad que no tiene un contexto primario, el identificador de seguimiento se generará automáticamente mediante números aleatorios. TraceIdGenerator se puede usar para invalidar el algoritmo de generación de identificadores de seguimiento predeterminado del entorno de ejecución.

TraceStateString

Obtiene o establece el encabezado W3C tracestate.

Métodos

AddBaggage(String, String)

Actualiza Activity para tener un nuevo elemento de equipaje con la clave y el valor especificados.

AddEvent(ActivityEvent)

Agrega el evento de actividad especificado a la lista de eventos.

AddException(Exception, TagList, DateTimeOffset)

Representa una operación con el contexto que se usará para el registro.

AddLink(ActivityLink)

Representa una operación con el contexto que se usará para el registro.

AddTag(String, Object)

Actualiza la actividad para que tenga una etiqueta con un key adicional y value.

AddTag(String, String)

Actualiza Activity para que tenga una etiqueta nueva con los elementos key y value proporcionados.

Dispose()

Detiene la actividad si ya se ha iniciado y notifica a cualquier cliente de escucha de eventos. De lo contrario, no ocurrirá nada.

Dispose(Boolean)

Cuando se invalida mediante un tipo derivado, este método libera los recursos asignados.

EnumerateEvents()

Enumera los ActivityEvent objetos adjuntos a este objeto Activity.

EnumerateLinks()

Enumera los ActivityLink objetos adjuntos a este objeto Activity.

EnumerateTagObjects()

Enumera las etiquetas adjuntas a este objeto Activity.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetBaggageItem(String)

Devuelve el valor de un par clave-valor agregado a la actividad con AddBaggage(String, String).

GetCustomProperty(String)

Devuelve el objeto asignado al nombre de propiedad especificado.

GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetTagItem(String)

Devuelve el valor de la etiqueta Activity asignada a la clave de entrada. Devuelve null si esa clave no existe.

GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
SetBaggage(String, String)

Agregue o actualice el equipaje de actividad con la clave de entrada y el valor. Si el valor de entrada es null - si la colección tiene cualquier equipaje con la misma clave, este equipaje se quitará de la colección. - de lo contrario, no ocurrirá nada y la colección no cambiará. Si el valor de entrada no es - null si la colección tiene equipaje con la misma clave, el valor asignado a esta clave se actualizará con el nuevo valor de entrada. - de lo contrario, la clave y el valor se agregarán como un nuevo equipaje a la colección. El artículo de equipaje se actualizará o quitará solo si se agregó originalmente a la actividad actual. Los artículos heredados de los elementos primarios no se cambiarán o quitarán, el nuevo artículo se agregará al equipaje de actividad actual en su lugar.

SetCustomProperty(String, Object)

Adjunta cualquier objeto personalizado a esta actividad. Si el propertyName especificado estaba previamente asociado a otro objeto, la propiedad se actualizará para asociarse al propertyValue nuevo en su lugar. Se recomienda usar un nombre de propiedad único para evitar conflictos con cualquier usuario que use el mismo valor.

SetEndTime(DateTime)

Actualiza Activity para establecer su elemento Duration como la diferencia entre StartTimeUtc y la hora de finalización especificada.

SetIdFormat(ActivityIdFormat)

Establece el formato del identificador de este objeto Activity antes de que se inicie.

SetParentId(ActivityTraceId, ActivitySpanId, ActivityTraceFlags)

Establece el identificador principal mediante la convención W3C de un elemento TraceId y un elemento SpanId.

SetParentId(String)

Actualiza Activity para indicar que el elemento Activity con un identificador parentId ha producido Activity.

SetStartTime(DateTime)

Establece la hora de inicio de Activity.

SetStatus(ActivityStatusCode, String)

Establece el código de estado y la descripción en el objeto de actividad actual.

SetTag(String, Object)

Agrega o actualiza la etiqueta de actividad con el valor y la clave de entrada.

Start()

Inicia la actividad.

Stop()

Detiene la actividad.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Eventos

CurrentChanged

Se produce cuando cambia el valor Current.

Se aplica a