Activity Clase

Definición

Espacio de nombres:

System.Diagnostics

Ensamblado:

System.Diagnostics.DiagnosticSource.dll

Paquete:

System.Diagnostics.DiagnosticSource v9.0.0-preview.3.24172.9

Source:

Activity.cs

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

public ref class Activity : IDisposable

public class Activity : IDisposable

type Activity = class
    interface IDisposable

Public Class Activity
Implements IDisposable

Herencia

Object

Activity

Implementaciones

IDisposable

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.
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.