<add> , element dla <odbiorników> na potrzeby <śledzenia>

Artykuł
04/06/2024

Dodaje odbiornik do kolekcji Odbiorniki .

<konfiguracji>
  <System.diagnostics>
    <Śledzenia>
      <Słuchaczy>
        <add>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	opis
type	Atrybut wymagany. Określa typ odbiornika. Należy użyć ciągu spełniającego wymagania określone w temacie Określanie w pełni kwalifikowanych nazw typów.
Initializedata	Atrybut opcjonalny. Ciąg przekazany do konstruktora dla określonej klasy.
name	Atrybut opcjonalny. Określa nazwę odbiornika.

Elementy podrzędne

Element	opis
<filter>	Dodaje filtr do odbiornika w `Listeners` kolekcji na potrzeby śledzenia.

Elementy nadrzędne

Element	opis
`configuration`	Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework.
`listeners`	Określa odbiornik, który zbiera, przechowuje i kieruje komunikaty. Odbiorniki kierują dane wyjściowe śledzenia do odpowiedniego obiektu docelowego.
`system.diagnostics`	Określa element główny sekcji konfiguracji ASP.NET.
`trace`	Zawiera odbiorniki, które zbierają, przechowują i śledzą komunikaty śledzenia tras.

Uwagi

Klasy Debug i Trace współdzielą tę samą kolekcję Odbiorniki . Jeśli dodasz obiekt odbiornika do kolekcji w jednej z tych klas, druga klasa używa tego samego odbiornika. Klasy odbiornika pochodzą z klasy TraceListener.

Jeśli nie określisz name atrybutu odbiornika śledzenia, Name wartość domyślna odbiornika śledzenia to pusty ciąg (""). Jeśli aplikacja ma tylko jeden odbiornik, możesz dodać go bez określania nazwy i usunąć ją, określając pusty ciąg nazwy. Jeśli jednak aplikacja ma więcej niż jeden odbiornik, należy określić unikatowe nazwy dla każdego odbiornika śledzenia, co umożliwia identyfikowanie poszczególnych odbiorników śledzenia i zarządzanie nimi w ramach Listeners kolekcji i Listeners .

Uwaga

Dodanie więcej niż jednego odbiornika śledzenia tego samego typu i o tej samej nazwie powoduje dodanie tylko jednego odbiornika śledzenia tego typu i nazwy do Listeners kolekcji. Można jednak programowo dodać do kolekcji Listeners wiele identycznych odbiorników.

Wartość atrybutu initializeData zależy od typu tworzonego odbiornika. Nie wszystkie odbiorniki śledzenia wymagają określenia parametru initializeData.

Uwaga

Jeśli używasz atrybutu initializeData , może zostać wyświetlone ostrzeżenie kompilatora "Atrybut initializeData nie jest zadeklarowany". To ostrzeżenie występuje, ponieważ ustawienia konfiguracji są weryfikowane względem abstrakcyjnej klasy TraceListenerbazowej , która nie rozpoznaje atrybutu initializeData . Zazwyczaj można zignorować to ostrzeżenie dla implementacji odbiornika śledzenia, które mają konstruktor, który przyjmuje parametr.

W poniższej tabeli przedstawiono odbiorniki śledzenia dołączone do programu .NET Framework i opisano wartość ich atrybutów initializeData .

Trace listener, klasa	initializeData wartość atrybutu
System.Diagnostics.ConsoleTraceListener	Wartość `useErrorStream` konstruktora ConsoleTraceListener . `initializeData` Ustaw atrybut na "`true`", aby zapisać dane wyjściowe śledzenia i debugowania na Console.Error; "`false`" do zapisu w pliku Console.Out.
System.Diagnostics.DelimitedListTraceListener	Nazwa pliku do DelimitedListTraceListener zapisu.
System.Diagnostics.EventLogTraceListener	Nazwa istniejącego źródła dziennika zdarzeń.
System.Diagnostics.EventSchemaTraceListener	Nazwa pliku, do którego jest zapisywany EventSchemaTraceListener plik.
System.Diagnostics.TextWriterTraceListener	Nazwa pliku, do którego jest zapisywany TextWriterTraceListener plik.
System.Diagnostics.XmlWriterTraceListener	Nazwa pliku, do którego jest zapisywany XmlWriterTraceListener plik.

Przykład

W poniższym przykładzie pokazano, jak używać <elementów dodawania> do dodawania odbiorników MyListener i MyEventListener do kolekcji Odbiorniki . MyListener Tworzy plik o nazwie MyListener.log i zapisuje dane wyjściowe w pliku. MyEventListener tworzy wpis w dzienniku zdarzeń.

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

Share via