İzlenecek Yol: My.Application.Log Çıktısını Filtreleme (Visual Basic)

  • Makale
  • Okumak için 2 dakika

Bu izlenecek yol, nesneden My.Application.Log dinleyicilerine hangi bilgilerin geçtiğini Log ve hangi bilgilerin dinleyiciler tarafından yazıldığını denetlemek için nesnenin varsayılan günlük filtrelemesinin nasıl değiştirileceğini gösterir. Yapılandırma bilgileri uygulamanın yapılandırma dosyasında depolandığından, uygulamayı oluşturduktan sonra bile günlüğe kaydetme davranışını değiştirebilirsiniz.

Başlarken

Yazan her ileti My.Application.Log , bir ilişkili önem düzeyine sahiptir ve bu da filtreleme mekanizmalarının günlük çıkışını denetlemek için kullandığı bir önem düzeyi vardır Bu örnek uygulama My.Application.Log , farklı önem düzeylerindeki çeşitli günlük iletilerini yazmak için yöntemler kullanır.

Örnek uygulamayı derlemek için

  1. yeni bir Visual Basic Windows uygulama projesi açın.

  2. Form1 adına button1 adlı bir düğme ekleyin.

  3. ClickButton1 için olay işleyicisinde aşağıdaki kodu ekleyin:

    ' Activity tracing information
My.Application.Log.WriteEntry("Entering Button1_Click", TraceEventType.Start)

' Tracing information
My.Application.Log.WriteEntry("In Button1_Click", TraceEventType.Information)

' Create an exception to log.
Dim ex As New ApplicationException
' Exception information
My.Application.Log.WriteException(ex)

' Activity tracing information
My.Application.Log.WriteEntry("Leaving Button1_Click", TraceEventType.Stop)

  4. Uygulamayı hata ayıklayıcıda çalıştırın.

  5. Button1'e basın.

    Uygulama, uygulamanın hata ayıklama çıktısına ve günlük dosyasına aşağıdaki bilgileri yazar.

    DefaultSource Information: 0 : In Button1_Click

    DefaultSource Error: 2 : Error in the application.

  6. Uygulamayı kapatın.

    Uygulamanın hata ayıklama çıkış penceresini görüntüleme hakkında daha fazla bilgi için bkz. Çıkış penceresi. Uygulamanın günlük dosyasının konumu hakkında daha fazla bilgi için bkz . Walkthrough: My. Application. log bilgisinin nereden yazabileceğini belirleme.

    Not

    Varsayılan olarak uygulama kapandığında günlük dosyası çıkışını temizler.

    Yukarıdaki örnekte, yöntemine yapılan ikinci çağrı ve yöntemine yapılan WriteEntry çağrı WriteException günlük çıktısını üretir, ancak yöntemin ilk ve son çağrıları WriteEntry değildir. Bunun nedeni, önem seviyelerinin WriteEntry WriteException "bilgi" ve "hata" olmasına ve her ikisinin de My.Application.Log nesnenin varsayılan günlük filtrelemesine izin verdiği anlamına gelir. Bununla birlikte, "Başlat" ve "Durdur" önem derecesindeki olaylar günlük çıktısı üretmesinin engellenmektedir.

Tüm My. Application. log dinleyicileri için filtreleme

My.Application.LogNesnesi SourceSwitch DefaultSwitch , WriteEntry ve yöntemlerinden hangi iletilerin günlük dinleyicilerine geçireceğini denetlemek için adlandırılmış bir kullanır WriteException . DefaultSwitchDeğerini sabit listesi değerlerinden birine ayarlayarak uygulamanın yapılandırma dosyasında yapılandırabilirsiniz SourceLevels . Varsayılan olarak, değeri "bilgi" ' dir.

Bu tablo, belirli bir ayar için, günlüğe kaydedilecek bir ileti yazmak için gereken önem derecesini gösterir DefaultSwitch .

DefaultSwitch değeri Çıkış için gereken ileti önem derecesi
Critical Critical
Error Critical veya Error
Warning Critical, Error , veya Warning
Information Critical, Error , Warning veya Information
Verbose Critical,,, Error Warning Information veya Verbose
ActivityTracing Start,,, Stop Suspend Resume veya Transfer
All Tüm iletilere izin verilir.
Off Tüm iletiler engellenir.

Not

WriteEntryVe WriteException yöntemlerinin her biri önem düzeyi belirtmeyen bir aşırı yüklemeye sahiptir. Aşırı yükleme için örtülü önem düzeyi WriteEntry "bilgi" ve aşırı yükleme için örtülü önem düzeyi WriteException "hata" dır.

Bu tabloda, önceki örnekte gösterilen günlük çıktısı açıklanmaktadır: varsayılan DefaultSwitch "bilgi" ayarıyla, yönteme yalnızca ikinci çağrı WriteEntry ve yönteme yapılan çağrı WriteException günlük çıkışı oluşturur.

Yalnızca etkinlik izleme olaylarını günlüğe kaydetmek için

  1. Çözüm Gezgini app.config sağ tıklayın ve Aç' ı seçin.

    -veya-

    app.config dosya yoksa:

    1. Project menüsünde yeni öğe ekle' yi seçin.

    2. Yeni öğe Ekle Iletişim kutusundan uygulama yapılandırma dosyası' nı seçin.

    3. Ekle'ye tıklayın.

  2. <switches>Üst düzey bölümde bulunan bölümünde olan bölümünü bulun <system.diagnostics> <configuration> .

  3. Anahtarlar koleksiyonuna ekleyen öğeyi bulun DefaultSwitch . Bu öğe şuna benzer görünmelidir:

    <add name="DefaultSwitch" value="Information" />

  4. valueÖzniteliğin değerini "ActivityTracing" olarak değiştirin.

  5. app.config dosyasının içeriği aşağıdaki XML 'e benzer olmalıdır:

    <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.diagnostics>
    <sources>
      <!-- This section configures My.Application.Log -->
      <source name="DefaultSource" switchName="DefaultSwitch">
        <listeners>
          <add name="FileLog"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="DefaultSwitch" value="ActivityTracing" />
    </switches>
    <sharedListeners>
      <add name="FileLog"
           type="Microsoft.VisualBasic.Logging.FileLogTraceListener,
                 Microsoft.VisualBasic, Version=8.0.0.0,
                 Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a,
                 processorArchitecture=MSIL"
           initializeData="FileLogWriter"/>
    </sharedListeners>
  </system.diagnostics>
</configuration>

  6. Uygulamayı hata ayıklayıcıda çalıştırın.

  7. Button1'e basın.

    Uygulama aşağıdaki bilgileri uygulamanın hata ayıklama çıktısına ve günlük dosyasına yazar:

    DefaultSource Start: 4 : Entering Button1_Click

    DefaultSource Stop: 5 : Leaving Button1_Click

  8. Uygulamayı kapatın.

  9. valueÖzniteliğin değerini "Information" olarak değiştirin.

    Not

    DefaultSwitchYalnızca anahtar ayarı denetimleri My.Application.Log . .NET System.Diagnostics.Trace ve System.Diagnostics.Debug sınıfların nasıl davranacağını değiştirmez.

My. Application. log dinleyicileri Için bireysel filtreleme

Önceki örnekte, tüm çıktılar için filtrelemenin nasıl değiştirileceği gösterilmektedir My.Application.Log . Bu örnek, tek bir günlük dinleyicisinin nasıl filtreleneceğini gösterir. Varsayılan olarak, uygulamanın, uygulamanın hata ayıklama çıktısına ve günlük dosyasına yazan iki dinleyicisi vardır.

Yapılandırma dosyası, her birinin bir filtreye benzer bir filtreye sahip olmasını sağlayarak günlük dinleyicilerinin davranışını denetler My.Application.Log . Günlük dinleyicisi yalnızca, iletinin önem derecesine yalnızca günlüğün DefaultSwitch ve günlük dinleyicinin filtresi tarafından izin veriliyorsa bir ileti çıktı.

Bu örnek, yeni bir hata ayıklama dinleyicisi için filtrelemenin nasıl yapılandırılacağını ve nesneye nasıl ekleneceğini gösterir Log . Varsayılan hata ayıklama dinleyicisi Log nesnesinden kaldırılmalıdır, bu nedenle hata ayıklama iletilerinin yeni hata ayıklama dinleyicisinden geldiği temizlenmelidir.

Yalnızca etkinlik izleme olaylarını günlüğe kaydetmek için

  1. Çözüm Gezgini app.config sağ tıklayın ve Aç' ı seçin.

    -veya

    app.config dosya yoksa:

    1. Project menüsünde yeni öğe ekle' yi seçin.

    2. Yeni öğe Ekle Iletişim kutusundan uygulama yapılandırma dosyası' nı seçin.

    3. Ekle'ye tıklayın.

  2. Çözüm Gezgini app.config sağ tıklayın. Aç' ı seçin.

  3. Bölümünün <listeners> <source> altında bulunan name "DefaultSource" özniteliğine sahip bölümünde bölümünü bulun <sources> . <sources>Bölümü, <system.diagnostics> bölümünün üst düzey bölümünde yer aldığı bölümdür <configuration> .

  4. Bu öğeyi <listeners> bölümüne ekleyin:

    <!-- Remove the default debug listener. -->
<remove name="Default"/>
<!-- Add a filterable debug listener. -->
<add name="NewDefault"/>

  5. Bölümünde, <sharedListeners> üst düzey bölümünde bölümünde bulunan bölümünü bulun <system.diagnostics> <configuration> .

  6. Bu öğeyi bu bölüme ekleyin <sharedListeners> :

    <add name="NewDefault"
     type="System.Diagnostics.DefaultTraceListener,
           System, Version=2.0.0.0, Culture=neutral,
           PublicKeyToken=b77a5c561934e089,
           processorArchitecture=MSIL">
    <filter type="System.Diagnostics.EventTypeFilter"
            initializeData="Error" />
</add>

    EventTypeFilterFiltre, SourceLevels sabit listesi değerlerinden birini özniteliği olarak alır initializeData .

  7. app.config dosyasının içeriği aşağıdaki XML 'e benzer olmalıdır:

    <?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.diagnostics>
    <sources>
      <!-- This section configures My.Application.Log -->
      <source name="DefaultSource" switchName="DefaultSwitch">
        <listeners>
          <add name="FileLog"/>
          <!-- Remove the default debug listener. -->
          <remove name="Default"/>
          <!-- Add a filterable debug listener. -->
          <add name="NewDefault"/>
        </listeners>
      </source>
    </sources>
    <switches>
      <add name="DefaultSwitch" value="Information" />
    </switches>
    <sharedListeners>
      <add name="FileLog"
           type="Microsoft.VisualBasic.Logging.FileLogTraceListener,
                 Microsoft.VisualBasic, Version=8.0.0.0,
                 Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a,
                 processorArchitecture=MSIL"
           initializeData="FileLogWriter"/>
      <add name="NewDefault"
           type="System.Diagnostics.DefaultTraceListener,
                 System, Version=2.0.0.0, Culture=neutral,
                 PublicKeyToken=b77a5c561934e089,
                 processorArchitecture=MSIL">
        <filter type="System.Diagnostics.EventTypeFilter"
                initializeData="Error" />
      </add>
    </sharedListeners>
  </system.diagnostics>
</configuration>

  8. Uygulamayı hata ayıklayıcıda çalıştırın.

  9. Button1'e basın.

    Uygulama, uygulamanın günlük dosyasına aşağıdaki bilgileri yazar:

    Default Information: 0 : In Button1_Click

    Default Error: 2 : Error in the application.

    Uygulama daha kısıtlayıcı filtreleme nedeniyle uygulamanın hata ayıklama çıktısına daha az bilgi yazar.

    Default Error 2 Error

  10. Uygulamayı kapatın.

Dağıtımdan sonra günlük ayarlarını değiştirme hakkında daha fazla bilgi için bkz. Uygulama Günlükleriyle Çalışma.

Ayrıca bkz.