TraceSource.TraceEvent Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners.
TraceEvent(TraceEventType, Int32) |
Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento y el identificador de evento especificados. |
TraceEvent(TraceEventType, Int32, String) |
Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el mensaje especificados. |
TraceEvent(TraceEventType, Int32, String, Object[]) |
Escribe un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el formato y la matriz de argumentos especificados. |
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento y el identificador de evento especificados.
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer)
Parámetros
- eventType
- TraceEventType
Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.
- id
- Int32
Identificador numérico para el evento.
- Atributos
Excepciones
Se ha intentado realizar la traza de un evento durante la finalización.
Ejemplos
En el ejemplo de código siguiente se muestra el uso del TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase TraceSource.
ts.TraceEvent(TraceEventType.Warning, 1);
ts.TraceEvent(TraceEventType.Warning, 1)
Comentarios
El TraceEvent método está diseñado para realizar un seguimiento de eventos que las herramientas pueden procesar automáticamente. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen específico realiza un seguimiento de un evento específico.
El TraceEvent método llama al ShouldTrace método del SourceSwitch objeto devuelto por la Switch propiedad . Si ShouldTrace devuelve true
, TraceEvent llama al método correspondiente TraceEvent de cada agente de escucha. De lo contrario, TraceEvent devuelve sin llamar a los métodos de los agentes de escucha.
El contenido de seguimiento es específico del agente de escucha. Si la implementación del agente de escucha no invalida el método, la salida predeterminada es el nombre del origen de seguimiento, su identidad numérica y el tipo de evento. El contenido de seguimiento adicional depende del valor de propiedad del agente de TraceOutputOptions escucha.
Nota
El EventLogTraceListener objeto está limitado a un valor máximo id
de 65 535. Si el id
valor especificado es mayor que 65 535, usa EventLogTraceListener 65 535.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
Escribe un mensaje de evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el mensaje especificados.
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? message);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string message);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, message As String)
Parámetros
- eventType
- TraceEventType
Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.
- id
- Int32
Identificador numérico para el evento.
- message
- String
Mensaje de seguimiento que se va a escribir.
- Atributos
Excepciones
Se ha intentado realizar la traza de un evento durante la finalización.
Ejemplos
En el ejemplo de código siguiente se muestra el uso del TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase TraceSource.
// Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found");
' Issue file not found message as a warning.
ts.TraceEvent(TraceEventType.Warning, 2, "File Test not found")
Comentarios
El TraceEvent método está diseñado para realizar un seguimiento de eventos que las herramientas pueden procesar automáticamente. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen específico realiza un seguimiento de un evento específico.
El TraceEvent método llama al ShouldTrace método del SourceSwitch objeto devuelto por la Switch propiedad . Si ShouldTrace devuelve true
, TraceEvent llama al método correspondiente TraceEvent de cada agente de escucha. De lo contrario, TraceEvent devuelve sin llamar a los métodos de los agentes de escucha.
El contenido de seguimiento es específico del agente de escucha. Si la implementación del agente de escucha no invalida el método, la salida predeterminada es el nombre del origen de seguimiento, su identidad numérica, el tipo de evento y el mensaje. El contenido de seguimiento adicional depende del valor de propiedad del agente de TraceOutputOptions escucha.
Nota
El EventLogTraceListener objeto está limitado a un valor máximo id
de 65 535. Si el id
valor especificado es mayor que 65 535, el EventLogTraceListener objeto usa 65 535.
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
- Source:
- TraceSource.cs
Escribe un evento de seguimiento en los agentes de escucha de seguimiento de la colección Listeners con el tipo de evento, el identificador de evento y el formato y la matriz de argumentos especificados.
public:
void TraceEvent(System::Diagnostics::TraceEventType eventType, int id, System::String ^ format, ... cli::array <System::Object ^> ^ args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object?[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string? format, params object?[]? args);
[System.Diagnostics.Conditional("TRACE")]
public void TraceEvent (System.Diagnostics.TraceEventType eventType, int id, string format, params object[] args);
[<System.Diagnostics.Conditional("TRACE")>]
member this.TraceEvent : System.Diagnostics.TraceEventType * int * string * obj[] -> unit
Public Sub TraceEvent (eventType As TraceEventType, id As Integer, format As String, ParamArray args As Object())
Parámetros
- eventType
- TraceEventType
Uno de los valores de enumeración que especifica el tipo de evento de los datos de seguimiento.
- id
- Int32
Identificador numérico para el evento.
- format
- String
Cadena con formato compuesto que contiene texto mezclado con cero o más elementos de formato que corresponden a objetos de la matriz args
.
- args
- Object[]
Matriz de object
que contiene cero o más objetos a los que se va a aplicar formato.
- Atributos
Excepciones
format
es null
.
format
no es válido.
o bien
El número que indica que un argumento al que se va a dar formato es menor que cero, o mayor o igual que el número de objetos proporcionados a los que se va a dar formato.
Se ha intentado realizar la traza de un evento durante la finalización.
Ejemplos
En el ejemplo de código siguiente se muestra el uso del TraceEvent(TraceEventType, Int32) método para pasar un evento de seguimiento a los agentes de escucha. Este ejemplo de código es parte de un ejemplo más grande proporcionado para la clase TraceSource.
// Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test");
' Issue file not found message as a verbose event using a formatted string.
ts.TraceEvent(TraceEventType.Verbose, 3, "File {0} not found.", "test")
Comentarios
Para obtener más información sobre el format
parámetro , vea Formato compuesto.
El TraceEvent método está diseñado para realizar un seguimiento de eventos que las herramientas pueden procesar automáticamente. Por ejemplo, una herramienta de supervisión puede notificar a un administrador si un origen específico realiza un seguimiento de un evento específico.
El TraceEvent método llama al ShouldTrace método del SourceSwitch objeto devuelto por la Switch propiedad . Si ShouldTrace devuelve true
, TraceEvent llama al método correspondiente TraceEvent de cada agente de escucha. De lo contrario, TraceEvent devuelve sin llamar a los métodos de los agentes de escucha.
El contenido de seguimiento es específico del agente de escucha. El método predeterminado TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) escribe el nombre de origen, el tipo de evento y la identidad numérica en el encabezado de seguimiento y, a continuación, llama al String.Format(IFormatProvider, String, Object[]) método , pasando la format
cadena y args
la matriz y usando la CultureInfo.InvariantCulture propiedad para dar formato a la cadena como salida del mensaje.
Nota
El EventLogTraceListener objeto está limitado a un valor máximo id
de 65 535. Si el id
valor especificado es mayor que 65 535, el EventLogTraceListener objeto usa 65 535.
Consulte también
- Formatos compuestos
- Cadenas con formato numérico estándar
- Cadenas con formato numérico personalizado
- Cadenas de formato DateTime estándar
- Cadenas de formato DateTime personalizadas
- Enumeration Format Strings
- Aplicar formato a tipos en .NET
Se aplica a
.NET 9 y otras versiones
Producto | Versiones |
---|---|
.NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0, 2.1 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: