<add> – element pro naslouchací procesy> pro <<trasování>

  • Článek

Přidá naslouchací proces do kolekce Naslouchací procesy .

<Konfigurace>
  <System.diagnostics>
    <Trasování>
      <Posluchače>
        <add>

Syntaxe

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

Atributy a prvky

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

Atributy

Atribut Popis
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.
Jméno Nepovinný atribut.

Určuje název naslouchacího procesu.

Podřízené prvky

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

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.
listeners Určuje naslouchací proces, který shromažďuje, ukládá a směruje zprávy. Naslouchací procesy směrují výstup trasování do vhodného cíle.
system.diagnostics Určuje kořenový prvek pro oddíl konfigurace ASP.NET.
trace Obsahuje naslouchací procesy, které shromažďují, ukládají a směrují trasovací zprávy.

Poznámky

Třídy Debug sdílejí Trace stejnou kolekci naslouchacích procesů . Pokud přidáte objekt naslouchacího procesu do kolekce v jedné z těchto tříd, druhá třída používá stejný naslouchací proces. Třídy naslouchacího procesu jsou odvozeny od TraceListenertřídy .

Pokud nezadáte name atribut naslouchacího procesu trasování, Name výchozí hodnota naslouchacího procesu trasování je prázdný řetězec (""). Pokud má vaše aplikace jenom jeden naslouchací proces, můžete ho přidat bez zadání názvu a odebrat zadáním prázdného řetězce pro název. Pokud ale vaše aplikace obsahuje více než jeden naslouchací proces, měli byste zadat jedinečné názvy pro každý naslouchací proces trasování, který umožňuje identifikovat a spravovat jednotlivé naslouchací procesy trasování v rámci Listeners kolekcí a Listeners kolekcí.

Poznámka:

Přidání více než jednoho naslouchacího procesu trasování stejného typu a se stejným názvem bude obsahovat pouze jeden naslouchací proces trasování tohoto typu a názvu, který se přidá do Listeners kolekce. Do kolekce však můžete programově přidat více identických naslouchacích procesů Listeners .

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 inicializovatData atributy.

Třída naslouchacího procesu trasování initializeData – hodnota atributu
System.Diagnostics.ConsoleTraceListener Hodnota useErrorStream konstruktoru ConsoleTraceListener . initializeData Nastavte atribut na "true" pro zápis trasování a ladění výstupu na Console.Error; "false" pro zápis do Console.Out.
System.Diagnostics.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.
System.Diagnostics.XmlWriterTraceListener Název souboru, do kterého se XmlWriterTraceListener zapisuje.

Příklad

Následující příklad ukazuje, jak pomocí <přidat> elementy přidat naslouchací MyListener procesy a MyEventListener do naslouchací procesy kolekce. MyListener vytvoří volaný MyListener.log soubor a zapíše výstup do souboru. MyEventListener vytvoří položku v protokolu událostí.

<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>

Viz také