Udostępnij przez

<filter>, element , aby dodać> odbiorniki <> do <<śledzenia>

  • Artykuł

Dodaje filtr do odbiornika w Listeners kolekcji na potrzeby śledzenia.

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

Składnia

<filter
  type="traceFilterClassName"
  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 filtru, który powinien dziedziczyć z TraceFilter klasy. Możesz użyć nazwy kwalifikowanej przestrzeni nazw typu, która odpowiada właściwości typu, lub można użyć w pełni kwalifikowanej nazwy typu FullName , w tym informacji o zestawie, która odpowiada AssemblyQualifiedName właściwości. Aby uzyskać informacje na temat w pełni kwalifikowanych nazw typów, zobacz Określanie w pełni kwalifikowanych nazw typów.
initializeData Atrybut opcjonalny.

Ciąg przekazany do konstruktora dla określonej klasy filtru.

Elementy podrzędne

Brak.

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.
trace Zawiera odbiorniki, które zbierają, przechowują i śledzą komunikaty śledzenia tras.
listeners Zawiera odbiorniki, które zbierają, przechowują i kierują komunikaty. Odbiorniki kierują dane wyjściowe śledzenia do odpowiedniego obiektu docelowego.
add Dodaje odbiornik do kolekcji Listeners .

Uwagi

Element <filter> musi znajdować się w elemecie <add> odbiornika śledzenia, który określa typ odbiornika, a nie tylko nazwę odbiornika zdefiniowanego w elementach <sharedListeners>. Jeśli odbiornik jest zdefiniowany w elementach <sharedListeners>, należy zdefiniować filtr dla tego odbiornika w tym elemecie.

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 za pomocą <filter> elementu dodać filtr do odbiornika console w Listeners kolekcji na potrzeby śledzenia, określając poziom zdarzenia filtru jako Error.

<configuration>  
  <system.diagnostics>  
    <trace autoflush="false" indentsize="4">  
      <listeners>  
        <add name="console"
          type="System.Diagnostics.ConsoleTraceListener" >  
          <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />  
        </add>  
        <remove name="Default" />  
      </listeners>  
    </trace>  
  </system.diagnostics>  
</configuration>

Zobacz też