<lägg till> element för <sharedListeners>

Artikel
04/06/2024

Lägger till en lyssnare i sharedListeners samlingen. sharedListenersär en samling lyssnare som alla <källor> eller <spårningar> kan referera till. Som standard placeras inte lyssnare sharedListeners i samlingen i en Listeners samling. De måste läggas till med namn i källan> eller< spårningen><. Det går inte att hämta lyssnarna sharedListeners i samlingen i kod vid körning.

<Konfiguration>
  <system.diagnostics>
    <sharedListeners>
      <Add>

Syntax

<add name="name"
  type="TraceListenerClassName, Version, Culture, PublicKeyToken"  
  initializeData="data"
  traceOutputOptions = "None"
/>

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Attribut	beskrivning
`name`	Obligatoriskt attribut. Anger namnet på lyssnaren som används för att lägga till den delade lyssnaren i en `Listeners` samling.
`type`	Obligatoriskt attribut. Anger typen av lyssnare. Du måste använda en sträng som uppfyller kraven som anges i Ange fullständigt kvalificerade typnamn.
`initializeData`	Valfritt attribut. Strängen som skickades till konstruktorn för den angivna klassen.
`traceOutputOptions`	Valfritt attribut. Strängrepresentationen av en eller flera TraceOptions uppräkningsmedlemmar som anger vilka data som ska skrivas till spårningsutdata. Flera objekt avgränsas med kommatecken. Standardvärdet är "Ingen".

Underordnade element

Element	Description
<filter>	Lägger till ett filter till en lyssnare i `sharedListeners` samlingen.

Överordnade element

Element	Description
`configuration`	Rotelementet i varje konfigurationsfil som används av vanliga språkkörnings- och .NET Framework-program.
`system.diagnostics`	Anger spårningslyssnare som samlar in, lagrar och dirigerar meddelanden och den nivå där en spårningsväxel anges.
`sharedListeners`	En samling lyssnare som alla käll- eller spårningselement kan referera till.

Kommentarer

Lyssnarklasserna som levereras med .NET Framework härleds från TraceListener klassen. Värdet för name attributet används för att lägga till den delade lyssnaren i en Listeners samling för antingen en spårning eller en spårningskälla. Värdet för initializeData attributet beror på vilken typ av lyssnare du skapar. Alla spårningslyssnare kräver inte att du anger initializeData.

Kommentar

När du använder initializeData attributet kan du få kompilatorvarningen "Attributet 'initializeData' har inte deklarerats.". Den här varningen inträffar eftersom konfigurationsinställningarna verifieras mot den abstrakta basklassen TraceListener, som inte känner igen initializeData attributet. Vanligtvis kan du ignorera den här varningen för spårningslyssnareimplementeringar som har en konstruktor som tar en parameter.

Följande tabell visar spårningslyssnare som ingår i .NET Framework och beskriver värdet för deras initializeData attribut.

Spårningslyssnarklass	initializeData-attributvärde
ConsoleTraceListener	Värdet `useErrorStream` för ConsoleTraceListener konstruktorn. `initializeData` Ange attributet till "`true`" för att skriva spårnings- och felsökningsutdata till standardfelströmmen. Ställ in det på "`false`" för att skriva till standardutdataströmmen.
DelimitedListTraceListener	Namnet på filen som skrivs DelimitedListTraceListener till.
System.Diagnostics.EventLogTraceListener	Namnet på en befintlig händelseloggkälla.
System.Diagnostics.EventSchemaTraceListener	Namnet på filen som skrivs EventSchemaTraceListener till.
System.Diagnostics.TextWriterTraceListener	Namnet på filen som skrivs TextWriterTraceListener till.
XmlWriterTraceListener	Namnet på filen som skrivs XmlWriterTraceListener till.

Konfigurationsfil

Det här elementet kan användas i datorkonfigurationsfilen (Machine.config) och programkonfigurationsfilen.

Exempel

I följande exempel visas hur du använder <add> element för att lägga till i sharedListenersTextWriterTraceListenertextListener samlingen. textListener läggs till med namn i Listeners samlingen för spårningskällan TraceSourceApp. Lyssnaren textListener skriver spårningsutdata till filen myListener.log.

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="TraceSourceApp" switchName="sourceSwitch"
        switchType="System.Diagnostics.SourceSwitch">  
        <listeners>  
          <add name="console"
            type="System.Diagnostics.ConsoleTraceListener"/>  
          <add name="textListener"/>  
          <remove name="Default"/>  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="textListener"
        type="System.Diagnostics.TextWriterTraceListener"
        initializeData="myListener.log"/>  
    </sharedListeners>  
    <switches>  
      <add name="sourceSwitch" value="Warning"/>  
    </switches>  
  </system.diagnostics>  
</configuration>

Dela via