<filter>, element — add> for <<sharedListeners>

  • Artykuł

Dodaje filtr do odbiornika w kolekcji sharedListeners .

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

Składnia

<filter type="System.Diagnostics.EventTypeFilter"
  initializeData="Warning" />

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. Można użyć tylko pełnej nazwy typu (w formacie Type.FullName właściwości) lub można użyć w pełni kwalifikowanej nazwy typu, w tym informacji o zestawie (w formacie Type.AssemblyQualifiedName właściwości). Aby uzyskać informacje na temat tworzenia w pełni kwalifikowanej nazwy typu, zobacz Określanie w pełni kwalifikowanych nazw typów.
Initializedata Atrybut opcjonalny.

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

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.
sharedListeners Kolekcja odbiorników, do których może się odwoływać dowolny element źródłowy lub element śledzenia.
add Dodaje odbiornik do kolekcji sharedListeners .

Uwagi

Jeśli odbiornik jest zdefiniowany w <add> elemecie <sharedListeners> elementu, filtr dla tego odbiornika powinien być zdefiniowany w <filter> elemecie, który jest elementem podrzędnym <add> elementu.

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 śledzenia w kolekcji sharedListeners .

<configuration>  
  <system.diagnostics>  
    <sources>  
      <source name="myTraceSource" >  
        <listeners>  
          <add name="console" />  
          <remove name="Default" />  
        </listeners>  
      </source>  
    </sources>  
    <sharedListeners>  
      <add name="console"
        type="System.Diagnostics.ConsoleTraceListener" >  
        <filter type="System.Diagnostics.EventTypeFilter"
          initializeData="Error" />  
      </add>  
    </sharedListeners>  
  </system.diagnostics>  
</configuration>

Zobacz też