<add> , element dla <elementów sharedListeners>

Artykuł
04/06/2024

Dodaje odbiornik do kolekcji sharedListeners . sharedListenersjest kolekcją odbiorników, do których może się odwoływać dowolne <źródło> lub< ślad.> Domyślnie odbiorniki w sharedListeners kolekcji nie są umieszczane w Listeners kolekcji. Muszą być dodawane według nazwy do <źródła> lub< śledzenia.> Nie można pobrać odbiorników w kolekcji w sharedListeners kodzie w czasie wykonywania.

<konfiguracji>
  <System.diagnostics>
    <sharedListeners>
      <add>

Składnia

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

Atrybuty i elementy

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

Atrybuty

Atrybut	opis
`name`	Atrybut wymagany. Określa nazwę odbiornika, który jest używany do dodawania odbiornika udostępnionego `Listeners` do kolekcji.
`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.
`traceOutputOptions`	Atrybut opcjonalny. Reprezentacja ciągu co najmniej jednego TraceOptions elementu członkowskiego wyliczenia, który wskazuje dane, które mają zostać zapisane w danych wyjściowych śledzenia. Wiele elementów jest rozdzielonych przecinkami. Wartość domyślna to "Brak".

Elementy podrzędne

Element	opis
<filter>	Dodaje filtr do odbiornika w kolekcji `sharedListeners` .

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.
`system.diagnostics`	Określa odbiorniki śledzenia, które zbierają, przechowują i kierują komunikaty oraz poziom, na którym ustawiono przełącznik śledzenia.
`sharedListeners`	Kolekcja odbiorników, do których może się odwoływać dowolny element źródłowy lub element śledzenia.

Uwagi

Klasy odbiornika dostarczane z programem .NET Framework pochodzą z TraceListener klasy . Wartość atrybutu name służy do dodawania udostępnionego odbiornika do Listeners kolekcji dla źródła śledzenia lub śledzenia. Wartość atrybutu initializeData zależy od typu tworzonego odbiornika. Nie wszystkie odbiorniki śledzenia wymagają określenia wartości 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 initializeData atrybutów.

Trace listener, klasa	initializeData wartość atrybutu
ConsoleTraceListener	Wartość `useErrorStream` konstruktora ConsoleTraceListener . `initializeData` Ustaw atrybut na "`true`", aby zapisać dane wyjściowe śledzenia i debugowania do standardowego strumienia błędów. Ustaw go na wartość "`false`", aby zapisać w standardowym strumieniu wyjściowym.
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.
XmlWriterTraceListener	Nazwa pliku, do którego jest zapisywany XmlWriterTraceListener plik.

Plik konfiguracji

Tego elementu można użyć w pliku konfiguracji maszyny (Machine.config) i pliku konfiguracji aplikacji.

Przykład

W poniższym przykładzie pokazano, jak używać <add> elementów do dodawania elementu TextWriterTraceListenertextListener do kolekcji sharedListeners . textListener element jest dodawany przez nazwę do Listeners kolekcji dla źródła TraceSourceAppśledzenia . Odbiornik textListener zapisuje dane wyjściowe śledzenia w pliku 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>

Share via