<add> – element pro <sharedListeners>

  • Článek

Přidá do sharedListeners kolekce naslouchací proces. sharedListenersje kolekce naslouchacích procesů, na které může odkazovat jakýkoli <zdroj> nebo <trasování.> Ve výchozím nastavení nejsou naslouchací procesy v sharedListeners kolekci umístěny.Listeners Musí být přidány podle názvu do <zdroje> nebo <trasování>. Není možné získat naslouchací procesy v kolekci v sharedListeners kódu za běhu.

<Konfigurace>
  <System.diagnostics>
    <sharedListeners>
      <add>

Syntaxe

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

Atributy a prvky

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut Popis
name Požadovaný atribut.

Určuje název naslouchacího procesu, který se používá k přidání sdíleného naslouchacího procesu do Listeners kolekce.
type Požadovaný atribut.

Určuje typ naslouchacího procesu. Je nutné použít řetězec, který splňuje požadavky zadané v zadání plně kvalifikovaných názvů typů.
initializeData Nepovinný atribut.

Řetězec předaný konstruktoru pro zadanou třídu.
traceOutputOptions Nepovinný atribut.

Řetězcová reprezentace jednoho nebo více TraceOptions členů výčtu, která označuje data, která mají být zapsána do výstupu trasování. Více položek je odděleno čárkami. Výchozí hodnota je None.

Podřízené prvky

Element (Prvek) Popis
<filter> Přidá filtr do naslouchacího procesu v kolekci sharedListeners .

Nadřazené prvky

Element (Prvek) Popis
configuration Kořenový prvek v každém konfiguračním souboru, který je používán modulem Common Language Runtime (CLR) a aplikacemi rozhraní .NET Framework.
system.diagnostics Určuje naslouchací procesy trasování, které shromažďují, ukládají a směrují zprávy a úroveň nastavení přepínače trasování.
sharedListeners Kolekce naslouchacíchprocesůch

Poznámky

Třídy naslouchacího procesu dodávané s rozhraním .NET Framework jsou odvozeny od TraceListener třídy. Hodnota atributu slouží k přidání sdíleného naslouchacího name procesu do Listeners kolekce pro trasování nebo zdroj trasování. Hodnota atributu initializeData závisí na typu naslouchacího procesu, který vytvoříte. Ne všechny naslouchací procesy trasování vyžadují, abyste zadali initializeData.

Poznámka:

Při použití atributu initializeData se může zobrazit upozornění kompilátoru "InicializovatData atribut není deklarován". K tomuto upozornění dochází, protože nastavení konfigurace jsou ověřena vůči abstraktní základní třídě TraceListener, která nerozpozná initializeData atribut. Obvykle můžete toto upozornění ignorovat pro implementace naslouchacího procesu trasování, které mají konstruktor, který přebírá parametr.

Následující tabulka ukazuje naslouchací procesy trasování, které jsou součástí rozhraní .NET Framework, a popisuje hodnotu jejich initializeData atributů.

Třída naslouchacího procesu trasování initializeData – hodnota atributu
ConsoleTraceListener Hodnota useErrorStream konstruktoru ConsoleTraceListener . initializeData Nastavte atribut na "true" pro zápis trasování a ladění výstupu do standardního chybového streamu; nastavte ho na "false" pro zápis do standardního výstupního streamu.
DelimitedListTraceListener Název souboru, do který DelimitedListTraceListener se zapisuje.
System.Diagnostics.EventLogTraceListener Název existujícího zdroje protokolu událostí.
System.Diagnostics.EventSchemaTraceListener Název souboru, do kterého se EventSchemaTraceListener zapisuje.
System.Diagnostics.TextWriterTraceListener Název souboru, do kterého se TextWriterTraceListener zapisuje.
XmlWriterTraceListener Název souboru, do kterého se XmlWriterTraceListener zapisuje.

Konfigurační soubor

Tento prvek lze použít v konfiguračním souboru počítače (Machine.config) a konfiguračním souboru aplikace.

Příklad

Následující příklad ukazuje, jak pomocí <add> elementů TextWriterTraceListenertextListener přidat do sharedListeners kolekce. textListener je přidán podle názvu kolekce Listeners pro zdroj TraceSourceApptrasování . Naslouchací textListener proces zapíše výstup trasování do souboru 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>

Viz také