<aggiungere> elemento per <listener> per <traccia><add> Element for <listeners> for <trace>

Aggiunge un listener per il listener insieme.Adds a listener to the Listeners collection.

<configuration><configuration>
<System. Diagnostics ><system.diagnostics>
<traccia ><trace>
<listener ><listeners>
<add><add>

SintassiSyntax

<add name="name"   
     type="trace listener class name, Version, Culture, PublicKeyToken"  
     initializeData="data"/>  

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
typetype Attributo obbligatorio.Required attribute.

Specifica il tipo del listener.Specifies the type of the listener. È necessario utilizzare una stringa che soddisfi i requisiti indicati in specifica di nomi di tipo completi.You must use a string that meets the requirements specified in Specifying Fully Qualified Type Names.
attributo initializeDatainitializeData Attributo facoltativo.Optional attribute.

La stringa passata al costruttore per la classe specificata.The string passed to the constructor for the specified class.
namename Attributo facoltativo.Optional attribute.

Specifica il nome del listener.Specifies the name of the listener.

Elementi figlioChild Elements

ElementoElement DescrizioneDescription
<filter><filter> Aggiunge un filtro a un listener di Listeners insieme per una traccia.Adds a filter to a listener in the Listeners collection for a trace.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
listeners Specifica un listener per la raccolta, la memorizzazione e indirizza i messaggi.Specifies a listener that collects, stores, and routes messages. I listener indirizzano l'output di traccia a una destinazione appropriata.Listeners direct the tracing output to an appropriate target.
system.diagnostics Consente di specificare l'elemento radice per la sezione di configurazione ASP.NET.Specifies the root element for the ASP.NET configuration section.
trace Contiene i listener che raccolgono, archiviano e indirizzano i messaggi di traccia.Contains listeners that collect, store, and route tracing messages.

NoteRemarks

Il Debug e Trace condividono lo stesso listener insieme.The Debug and Trace classes share the same Listeners collection. Se si aggiunge un oggetto listener alla raccolta in una di queste classi, l'altra classe utilizza lo stesso listener.If you add a listener object to the collection in one of these classes, the other class uses the same listener. Derivano le classi di listener di TraceListener.The listener classes derive from the TraceListener.

Se non si specifica il name attributo del listener di traccia, il Name delle impostazioni predefinite del listener di traccia in una stringa vuota ("").If you do not specify the name attribute of the trace listener, the Name of the trace listener defaults to an empty string (""). Se l'applicazione presenta un solo listener, è possibile aggiungerlo senza specificare un nome e rimuoverlo specificando una stringa vuota per il nome.If your application has only one listener, you can add it without specifying a name, and remove it by specifying an empty string for the name. Tuttavia, se l'applicazione presenta più di un listener, è necessario specificare nomi univoci per ogni listener di traccia, che consente di identificare e gestire singoli listener di traccia all'interno di Listeners e Listeners raccolte.However, if your application has more than one listener, you should specify unique names for each trace listener, which allows you to identify and manage individual trace listeners within the Listeners and Listeners collections.

Nota

Aggiunta di più di un listener di traccia, dello stesso tipo e con lo stesso nome risultati in un solo listener di traccia di quel tipo e nome viene aggiunto al Listeners insieme.Adding more than one trace listener of the same type and with the same name results in only one trace listener of that type and name being added to the Listeners collection. Tuttavia, è possibile aggiungere a livello di codice più listener identici per il Listeners insieme.However, you can programmatically add multiple identical listeners to the Listeners collection.

Il valore per il initializeData attributo dipende dal tipo di listener creato.The value for the initializeData attribute depends on the type of listener you create. Non tutti i listener di traccia è necessario specificare initializeData.Not all trace listeners require that you specify initializeData.

Nota

Quando si utilizza il initializeData attributo, è possibile che venga visualizzato l'avviso "l'attributo 'initializeData' non dichiarato." del compilatoreWhen you use the initializeData attribute, you may get the compiler warning "The 'initializeData' attribute is not declared." Questo avviso viene generato perché le impostazioni di configurazione vengono convalidate in base alla classe base astratta TraceListener, che non riconosce il initializeData attributo.This warning occurs because the configuration settings are validated against the abstract base class TraceListener, which does not recognize the initializeData attribute. In genere, è possibile ignorare questo avviso per le implementazioni di listener di traccia che dispone di un costruttore che accetta un parametro.Typically, you can ignore this warning for trace listener implementations that have a constructor that takes a parameter.

Nella tabella seguente mostra i listener di traccia inclusi in .NET Framework e descrive il valore della loro initializeData attributi.The following table shows the trace listeners that are included with the .NET Framework and describes the value of their initializeData attributes.

Classe di listener di tracciaTrace listener class valore dell'attributo initializeDatainitializeData attribute value
System.Diagnostics.ConsoleTraceListener Il useErrorStream valore per il ConsoleTraceListener costruttore.The useErrorStream value for the ConsoleTraceListener constructor. Impostare il initializeData attributo "true" per scrivere una traccia e debug di output per Console.Error; "false" per scrivere Console.Out.Set the initializeData attribute to "true" to write trace and debug output to Console.Error; "false" to write to Console.Out.
System.Diagnostics.DelimitedListTraceListener Il nome del file di DelimitedListTraceListener scrive.The name of the file the DelimitedListTraceListener writes to.
System.Diagnostics.EventLogTraceListener Il nome del nome di un'origine di log eventi esistenti.The name of the name of an existing event log source.
System.Diagnostics.EventSchemaTraceListener Il nome del file che il EventSchemaTraceListener scrive.The name of the file that the EventSchemaTraceListener writes to.
System.Diagnostics.TextWriterTraceListener Il nome del file che il TextWriterTraceListener scrive.The name of the file that the TextWriterTraceListener writes to.
System.Diagnostics.XmlWriterTraceListener Il nome del file che il XmlWriterTraceListener scrive.The name of the file that the XmlWriterTraceListener writes to.

EsempioExample

Nell'esempio seguente viene illustrato come utilizzare <aggiungere > elementi per aggiungere i listener MyListener e MyEventListener per il listener insieme.The following example shows how to use <add> elements to add the listeners MyListener and MyEventListener to the Listeners collection. MyListener Crea un file denominato MyListener.log e scrive l'output al file.MyListener creates a file called MyListener.log and writes the output to the file. MyEventListener Crea una voce nel registro eventi.MyEventListener creates an entry in the event log.

<configuration>  
   <system.diagnostics>  
      <trace autoflush="true" indentsize="0">  
         <listeners>  
            <add name="myListener" type="System.Diagnostics.TextWriterTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" initializeData="c:\myListener.log" />  
            <add name="MyEventListener"  
                 type="System.Diagnostics.EventLogTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"                 initializeData="MyConfigEventLog"/>  
            <add name="configConsoleListener"  
                 type="System.Diagnostics.ConsoleTraceListener, system, version=1.0.3300.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>  
         </listeners>  
      </trace>  
   </system.diagnostics>  
</configuration>  

Vedere ancheSee Also

Trace
Debug
EventLogTraceListener
ConsoleTraceListener
TextWriterTraceListener
Schema delle impostazioni di traccia e debugTrace and Debug Settings Schema
Listener di tracciaTrace Listeners