<eliminar> Elemento para <agentes de escucha> para <seguimiento>
Borra la colección Listeners
de un seguimiento.
<configuración>
<system.diagnostics>
<seguimiento>
<agentes de escucha>
<eliminar>
Sintaxis
<clear/>
Atributos y elementos
En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.
Atributos
Ninguno.
Elementos secundarios
Ninguno.
Elementos primarios
Elemento | Descripción |
---|---|
configuration |
Elemento raíz de cada archivo de configuración usado por las aplicaciones de Common Language Runtime y .NET Framework. |
system.diagnostics |
Especifica los agentes de escucha de seguimiento que recopilan, almacenan y enrutan mensajes, así como el nivel en el que está establecido un modificador de seguimiento. |
trace |
Contiene agentes de escucha que recopilan, almacenan y enrutan los mensajes de seguimiento. |
listeners |
Contiene clientes de escucha que recopilan, almacenan y enrutan los mensajes. Los agentes de escucha dirigen los resultados del seguimiento a un destino apropiado. |
Comentarios
El <clear>
elemento quita todos los agentes de escucha de la colección para el Listeners
seguimiento. Puede usar el elemento <clear>
antes de usar el elemento <add>
para estar seguro de que no hay otros agentes de escucha activos en la colección.
Puede borrar la Listeners
colección mediante programación llamando al Clear método en la Trace.Listeners propiedad (System.Diagnostics.Trace.Listeners.Clear()
).
Este elemento se puede usar en el archivo de configuración del equipo (Machine.config) o en el archivo de configuración de la aplicación.
Nota
El elemento <clear>
quita de DefaultTraceListener la colección Listeners
, modificando el comportamiento de los métodos Debug.Assert, Trace.Assert, Debug.Faily Trace.Fail. Llamar a un método Assert
o Fail
normalmente da como resultado la presentación de un cuadro de mensaje. Sin embargo, el cuadro de mensaje no se muestra si DefaultTraceListener no está en la colección Listeners
.
Ejemplo
En el ejemplo siguiente se muestra cómo usar el elemento <clear>
antes de usar el elemento <add>
para agregar el agente de escucha console
a la colección Listeners
para seguimiento.
<configuration>
<system.diagnostics>
<trace autoflush="false" indentsize="4">
<listeners>
<clear/>
<add name="console"
type="System.Diagnostics.ConsoleTraceListener" >
<filter type="System.Diagnostics.EventTypeFilter"
initializeData="Error" />
</add>
</listeners>
</trace>
</system.diagnostics>
</configuration>
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de