<Add> – element pro <naslouchací procesy> pro <zdroj>

  • Článek

Přidá do Listeners kolekce naslouchací proces pro zdroj trasování.

<Konfigurace>
  <System.diagnostics>
    <sources>
      <source>
        <Posluchače>
          <add>

Syntaxe

<add name="name"
  type="TraceListenerClassName, 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 Povinný atribut, pokud v kolekci odkazujete na naslouchací processharedListeners, v takovém případě na něj stačí odkazovat jenom podle názvu (viz příklad).

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. Vyvolá ConfigurationException se, pokud třída nemá konstruktor, který přebírá řetězec.
name Nepovinný atribut.

Určuje název naslouchacího procesu.
traceOutputOptions Nepovinný atribut.

Určuje TraceOutputOptions hodnotu vlastnosti pro naslouchací proces trasování.
[vlastní atributy] Volitelné atributy.

Určuje hodnotu atributů specifických pro naslouchací proces identifikovaný metodou GetSupportedAttributes pro tento naslouchací proces. Delimiter je příkladem dodatečného atributu jedinečného DelimitedListTraceListener pro třídu.

Podřízené prvky

Element (Prvek) Popis
<filter> Přidá filtr do naslouchacího Listeners procesu v kolekci pro zdroj 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.
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í.
sources Obsahuje zdroje trasování, které inicializuje trasování zpráv.
source Určuje zdroj trasování, který inicializuje trasovací zprávy.
listeners Určuje naslouchací procesy, které shromažďují, ukládají a směrují zprávy.

Poznámky

Třídy naslouchacího procesu dodávané s rozhraním .NET Framework jsou odvozeny od TraceListener třídy.

Pokud nezadáte name atribut naslouchacího procesu trasování, Name vlastnost naslouchacího procesu trasování se ve výchozím nastavení nastaví na prázdný řetězec (""). Pokud má vaše aplikace jenom jeden naslouchací proces, můžete ho přidat bez zadání názvu a můžete ho 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 pro každý naslouchací proces trasování zadat jedinečný název, který umožňuje identifikovat a spravovat jednotlivé naslouchací procesy trasování v kolekci TraceSource.Listeners .

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 initializeData atributů.

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 do standardního chybového streamu; nastavte ho na "false" pro zápis do standardního výstupního streamu.
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.

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 použít <add> elementy přidat naslouchací procesy console a textListener do Listeners kolekce 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é