Genomgång: Filtrera My.Application.Log-utdata (Visual Basic)

Den här genomgången visar hur du ändrar standardloggfiltreringen My.Application.Log för objektet, för att styra vilken information som skickas från Log objektet till lyssnarna och vilken information som skrivs av lyssnarna. Du kan ändra loggningsbeteendet även när du har skapat programmet, eftersom konfigurationsinformationen lagras i programmets konfigurationsfil.

Komma igång

Varje meddelande som My.Application.Log skriver har en associerad allvarlighetsgrad, som filtreringsmekanismer använder för att styra loggutdata. Det här exempelprogrammet använder My.Application.Log metoder för att skriva flera loggmeddelanden med olika allvarlighetsnivåer.

Så här skapar du exempelprogrammet

1. Öppna ett nytt Visual Basic Windows-programprojekt.

2. Lägg till en knapp med namnet Button1 i Form1.

3. Click Lägg till följande kod i händelsehanteraren för Button1:

   ' 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. Kör programmet i felsökningsprogrammet.

5. Tryck på Knapp1.

   Programmet skriver följande information till programmets felsökningsutdata och loggfil.

   DefaultSource Information: 0 : In Button1_Click

   DefaultSource Error: 2 : Error in the application.

6. Stäng programmet.

   Information om hur du visar programmets felsökningsutdatafönster finns i Utdatafönster. Information om platsen för programmets loggfil finns i Genomgång: Fastställa var my.application.log skriver information.

   Anmärkning

   Som standard töms loggfilens utdata när programmet stängs.

   I exemplet ovan genererar det andra anropet WriteEntry till metoden och anropet till WriteException metoden loggutdata, medan de första och sista anropen WriteEntry till metoden inte gör det. Det beror på att allvarlighetsgraderna WriteEntry för och WriteException är "Information" och "Fel", som båda tillåts av My.Application.Log objektets standardloggfiltrering. Händelser med allvarlighetsgraderna "Start" och "Stop" hindras dock från att generera loggutdata.

Filtrering för alla my.application.log-lyssnare

Objektet My.Application.Log använder ett SourceSwitch som heter DefaultSwitch för att styra vilka meddelanden som skickas från metoderna WriteEntry och WriteException till logglyssnarna. Du kan konfigurera DefaultSwitch i programmets konfigurationsfil genom att ange dess värde till ett av SourceLevels uppräkningsvärdena. Som standard är dess värde "Information".

Den här tabellen visar allvarlighetsgraden som krävs för att loggen ska kunna skriva ett meddelande till lyssnarna med en viss DefaultSwitch inställning.

I den här tabellen förklaras loggutdata som visas i föregående exempel: med standardinställningen DefaultSwitch "Information" genereras loggutdata endast från det andra anropet till WriteEntry-metoden och från anropet till WriteException-metoden.

Logga endast aktivitetsspårningshändelser

1. Högerklicka på app.config i Solution Explorer och välj Öppna.

   -eller-

   Om det inte finns någon app.config fil:

   1. På Projekt-menyn väljer du Lägg till nytt objekt.

   2. I dialogrutan Lägg till nytt objekt väljer du Programkonfigurationsfil.

   3. Klicka på Lägg till.

2. Leta upp avsnittet <switches>, som finns i avsnittet <system.diagnostics>, vilket är i avsnittet på översta nivån <configuration>.

3. Hitta det element som lägger till DefaultSwitch i växelsamlingen. Det bör se ut ungefär så här:

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

4. Ändra värdet för value attributet till "ActivityTracing".

5. Innehållet i app.config-filen bör likna följande XML:

   <?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. Kör programmet i felsökningsprogrammet.

7. Tryck på Knapp1.

   Programmet skriver följande information till programmets felsökningsutdata och loggfil:

   DefaultSource Start: 4 : Entering Button1_Click

   DefaultSource Stop: 5 : Leaving Button1_Click

8. Stäng programmet.

9. Ändra tillbaka värdet för value attributet till "Information".

   Anmärkning

   Växelinställningen DefaultSwitch styr endast My.Application.Log. Det ändrar inte hur .NET System.Diagnostics.Trace och System.Diagnostics.Debug klasserna beter sig.

Individuell filtrering för my.application.log-lyssnare

I föregående exempel visas hur du ändrar filtreringen för alla My.Application.Log utdata. Det här exemplet visar hur du filtrerar en enskild logglyssnare. Som standard har ett program två lyssnare som skriver till programmets felsökningsutdata och loggfilen.

Konfigurationsfilen styr beteendet för logglyssnare genom att låta var och en ha ett filter, vilket liknar en växel för My.Application.Log. En logglyssnare matar endast ut ett meddelande om meddelandets allvarlighetsgrad tillåts av både loggens DefaultSwitch och logglyssningsfiltret.

Det här exemplet visar hur du konfigurerar filtrering för en ny felsökningslyssnare och lägger till den i Log objektet. Standardlyssnaren Log för felsökning bör tas bort från objektet, så det är tydligt att felsökningsmeddelandena kommer från den nya felsökningslyssnaren.

Logga endast aktivitetsspårningshändelser

1. Högerklicka på app.config i Solution Explorer och välj Öppna.

   -eller-

   Om det inte finns någon app.config fil:

   1. På Projekt-menyn väljer du Lägg till nytt objekt.

   2. I dialogrutan Lägg till nytt objekt väljer du Programkonfigurationsfil.

   3. Klicka på Lägg till.

2. Högerklicka på app.config i Solution Explorer. Välj Öppna.

3. Leta upp <listeners>-avsnittet i <source>-avsnittet med name-attributet "DefaultSource", som finns under <sources>-avsnittet. Sektionen <sources> är under sektionen <system.diagnostics> i topplagssektionen <configuration>.

4. Lägg till det här elementet i <listeners> avsnittet:

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

5. Leta upp <sharedListeners>-avsnittet i <system.diagnostics>-avsnittet i det översta <configuration>-avsnittet.

6. Lägg till det här elementet i det <sharedListeners> avsnittet:

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

   EventTypeFilter Filtret tar ett av uppräkningsvärdena SourceLevels som attributinitializeData.

7. Innehållet i app.config-filen bör likna följande XML:

   <?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. Kör programmet i felsökningsprogrammet.

9. Tryck på Knapp1.

   Programmet skriver följande information till programmets loggfil:

   Default Information: 0 : In Button1_Click

   Default Error: 2 : Error in the application.

   Programmet skriver mindre information till programmets felsökningsutdata på grund av den mer restriktiva filtreringen.

   Default Error 2 Error

10. Stäng programmet.

Mer information om hur du ändrar logginställningar efter distributionen finns i Arbeta med programloggar.

Se även

• Genomgång: Fastställa var my.application.log skriver information
• Genomgång: Ändra var my.application.log skriver information
• Genomgång: Skapa anpassade logglyssnare
• Anvisningar: Skriva loggmeddelanden
• Trace-omkopplare
• Loggningsinformation från programmet