Podrobné pokyny: Vytvoření vlastního protokolu posluchače (Visual Basic)

Tento návod ukazuje, jak vytvořit vlastní protokolové posluchače a jak je nakonfigurovat k naslouchání na výstupu My.Application.Log adresářů.

Začínáme

Protokoloví posluchači musí dědit z třídy TraceListener.

Chcete-li vytvořit posluchače

• Ve vaší aplikace vytvořte třídu s názvem SimpleListener, které bude dědit z TraceListener.

  Public Class SimpleListener
      Inherits System.Diagnostics.TraceListener
  
      <Security.Permissions.HostProtection(Synchronization:=True)> 
      Public Overloads Overrides Sub Write(ByVal message As String)
          MsgBox("Write: " & message)
      End Sub
  
      <Security.Permissions.HostProtection(Synchronization:=True)> 
      Public Overloads Overrides Sub WriteLine(ByVal message As String)
          MsgBox("WriteLine: " & message)
      End Sub
  End Class
  

  Metoda Write a metoda WriteLine jsou požadovány základní třídou. Zavolejte MsgBox chcete-li zobrazit jejich vstup.

  Atribut HostProtectionAttribute se aplikuje na metody Write a WriteLine tak, aby jejich atributy odpovídaly atributům metod základní třídy. Atribut HostProtectionAttribute umožňuje hostiteli, který spouští kód, určit, zda kód zpřístupňuje hostitelskou ochranu synchronizace.

  Poznámka

  Atribut HostProtectionAttribute je efektivní pouze v nespravovaných aplikacích, které jsou spuštěny v CLR (Common Language Runtime) modulu a které implementují ochranu hostitel, jako je například SQL Server.

K zajištění používání vašeho protokolového posluchače v My.Application.Log , je nutné silně pojmenovat sestavení, které obsahuje váš protokolový posluchač.

Následující procedura poskytuje některé jednoduché kroky pro vytvoření silně pojmenovaných sestavení pro protokolové posluchače. Další informace naleznete v tématu Vytvoření a použití sestavení se silným názvem.

K silnému pojmenování sestavení pro protokolové posluchače

1. Mějte projekt vybrán v Průzkumníku řešení. V menu Projekt vyberte Vlastnosti. Další informace naleznete v tématu Úvod k Návrháři projektu.

2. Klikněte na tlačítko záložky Podepisování.

3. Označte box Podepsání sestavení.

4. Označte <Nový> v rozevíracím menu Zvolte klíčový soubor s silným názvem..

   Bude otevřeno dialogové okno Vytvořit klíč se silný názvem.

5. Do boxu Název klíčového souboru zadejte název pro klíčový soubor.

6. Zadejte heslo do pole Zadejte heslo a polePotvrdit heslo .

7. Klepněte na tlačítko OK.

8. Znovu sestavte aplikaci.

Přidání posluchače

Nyní když má sestavení silný název, je nutné určit silný název posluchače tak, aby My.Application.Log používal vašeho protokolového posluchače.

Formát silně pojmenovaného typu je následující.

<název typu >, <název sestavení>, <číslo verze>, <jazyková verze>, <silný název>

K zjištění silného názvu posluchače

• Následující kód ukazuje, jak lze zjistit název silně pojmenovaného typu pro SimpleListener.

  Public Sub DisplaySimpleListenerStrongName()
      Dim t As Type = GetType(SimpleListener)
      MsgBox(t.FullName & ", " & t.Assembly.FullName)
  End Sub
  

  Silný název typu závisí na vašem projektu.

Se silným názvem můžete přidat posluchače do kolekce protokolových posluchačů v My.Application.Log.

Přidání posluchače do <languageKeyword>My.Application.Log</languageKeyword>

1. Klikněte pravým tlačítkem myši na soubor app.config v Průzkumníku řešení a potom klikněte na tlačítko Otevřít.

   -nebo-

   Pokud existuje soubor app.config:

   1. V nabídce Projekt klepněte na příkaz Přidat novou položku)

   2. Z dialogového rámečku Přidat novou položku, zvolte Aplikační konfigurační soubor.

   3. Klepněte na tlačítko Přidat.

2. Nalezněte oddíl <listeners>, v sekci <source> s atributem name nastaveným na "DefaultSource", který je umístěný v sekci <sources>. Sekce <sources> je umístěna v sekci <system.diagnostics>, která je v nejvyšší úroveň oddílu <configuration>.

3. Přidejte tento element do sekce <listeners>.

   <add name="SimpleLog" />
   

4. Nalezněte sekci <sharedListeners> v sekci <system.diagnostics>, které je v nejvyšší úroveň oddílu <configuration>.

5. Přidejte tento element do sekce <sharedListeners>.

   <add name="SimpleLog" type="SimpleLogStrongName" />
   

   Změňte hodnotu parametru SimpleLogStrongNametak, aby byl silným názvem posluchače.

Viz také

Úkoly

Postupy: Jak protokolovat vyjímky v jazyce Visual Basic

Postupy: Zprávy protokolu zápisu (Visual Basic)

Podrobné pokyny: Změna, kde My.Application.Log zapisuje informace (Visual Basic)

Odkaz

Microsoft.VisualBasic.Logging.Log

Koncepty

Práce s protokoly aplikace v jazyce Visual Basic