FileLogTraceListener Třída

Definice

public ref class FileLogTraceListener : System::Diagnostics::TraceListener

[System.Runtime.InteropServices.ComVisible(false)]
public class FileLogTraceListener : System.Diagnostics.TraceListener

[<System.Runtime.InteropServices.ComVisible(false)>]
type FileLogTraceListener = class
    inherit TraceListener

Public Class FileLogTraceListener
Inherits TraceListener

Dědičnost

Object

MarshalByRefObject

TraceListener

FileLogTraceListener

Atributy

ComVisibleAttribute

Poznámky

Třída FileLogTraceListener poskytuje funkce automatizované údržby pro archivaci souborů protokolu podle potřeby, a to každý den nebo pro jednotlivé aplikace. Tato funkce automatické archivace pomáhá snížit odpovědnost vývojářů a správců za údržbu.

Do kolekcí nebo lze přidat instanci objektu FileLogTraceListenerDebug.Listeners nebo Trace.Listeners a přesměrovat tak výstup z protokolování do textového souboru. Instance této třídy lze také přidat do My.Application.Log nebo My.Log (pro webové aplikace) v aplikacích jazyka Visual Basic. Další informace najdete v tématu Návod: Změna místa, kam My.Application.Log zapisuje informace.

Hlavní funkce této třídy jsou:

1. Funkce archivace. Soubory protokolu vygenerované touto třídou jsou pojmenovány podle základního názvu a data spolu s číslem pro odlišení souboru protokolu od po sobě jdoucích verzí protokolu. Nové soubory protokolů se vytvářejí podle potřeby.

   Explicitní forma názvu souboru je baseName[-dateStamp][-version].log, kde:

   • Část baseName je základní název protokolu určený BaseFileName vlastností.

   • Část dateStamp má formát "RRRR-MM-DD" a zobrazí se, když LogFileCreationSchedule je Daily nebo Weekly.

   • Pokud je se stejným baseName souborem protokolu potřeba více než jeden soubor protokolu a dateStamp, version přidá se k názvu souboru část, kladná Integer.

2. Více instancí tříd. Pokud instance FileLogTraceListener třídy zapisuje do souboru, který se používá:

   • Třída sdílí soubor, pokud ho FileLogTraceListener používá jiná instance třídy ve stejném procesu.

   • Třída vytvoří nový soubor protokolu pomocí dalšího dostupného názvu, pokud je soubor používán jiným procesem.

3. Bezpečnost vláken. Třída FileLogTraceListener je bezpečná pro přístup z více vláken. To vám umožní bezpečně zapisovat zprávy do protokolu z více vláken bez použití zámků.

Umístění souboru protokolu

• Vlastnost Location přebírá LogFileLocation výčet k určení jednoho z typických adresářů pro zápis souboru protokolu do.

• Pokud chcete protokol zapsat do jiného umístění, nastavte CustomLocation vlastnost na toto umístění.

Název souboru protokolu

• Základní název souboru protokolu je určen BaseFileName vlastností .

• Aktuální název souboru protokolu lze načíst z FullLogFileName vlastnosti . Je odvozen z několika dalších vlastností a aktuálního stavu protokolů v systému souborů.

Údržba protokolů

• Minimální frekvence vytváření nových souborů protokolu je určena LogFileCreationSchedule vlastností . Pokud je Daily hodnota nebo Weekly, vytvoří se nový soubor protokolu alespoň jednou denně nebo týdně a do FullLogFileName názvu se začlení razítko data.

• Maximální velikost souboru protokolu (v bajtech) je určena MaxFileSize vlastností. Pokud velikost souboru protokolu překročí tuto velikost, další zprávy zapsané do protokolu se zahodí a v závislosti na DiskSpaceExhaustedBehavior vlastnosti dojde k výjimce.

• Vlastnost ReserveDiskSpace určuje, kolik volného místa (v bajtech) musí být k dispozici. To pomáhá zajistit, že FileLogTraceListener třída nebude využívat veškeré dostupné místo na disku. DiskSpaceExhaustedBehavior Vlastnost slouží k určení chování zápisu protokolu, pokud je méně než ReserveDiskSpace volných bajtů.

Nastavení výstupu souboru protokolu

• Vlastnost AutoFlush určuje, jestli se má podkladový datový proud automaticky vyprázdnit po každém zápisu do souboru protokolu.

• Vlastnost Append určuje, zda se mají zprávy přidávat k aktuálnímu souboru protokolu, pokud je to povoleno, nebo je zapisovat do nového souboru protokolu.

• Vlastnost Delimiter určuje řetězec, který se má použít k oddělení polí ve zprávě protokolu.

• Vlastnost Encoding určuje kódování, které se má použít při vytváření nového souboru protokolu.

Výstup souboru protokolu

• Metody TraceData a TraceEvent zapisuje zprávy do souboru protokolu. Tyto metody zkontrolují LogFileCreationSchedule vlastnost spolu se všemi existujícími protokoly se stejným základním názvem a určí, jestli se má vytvořit nový protokol.

• Metoda Flush vyprázdní všechny zprávy aktuálně ve výstupní vyrovnávací paměti do souboru protokolu.

• Metoda Close zavře soubor protokolu, aby ho mohly používat jiné procesy.

Povolení výstupu

Pokud chcete používat naslouchací proces trasování, musíte povolit trasování nebo ladění. Následující syntaxe je specifická pro kompilátor. Pokud používáte jiné kompilátory než C# nebo Visual Basic, projděte si dokumentaci k kompilátoru.

• Pokud chcete povolit ladění v jazyce C#, přidejte /d:DEBUG příznak do příkazového řádku kompilátoru při kompilaci kódu nebo můžete přidat #define DEBUG na začátek souboru. V jazyce Visual Basic přidejte /d:DEBUG=True příznak do příkazového řádku kompilátoru.

• Pokud chcete povolit trasování v jazyce C#, přidejte /d:TRACE příznak do příkazového řádku kompilátoru při kompilaci kódu nebo přidejte #define TRACE do horní části souboru. V jazyce Visual Basic přidejte /d:TRACE=True příznak do příkazového řádku kompilátoru.

V aplikacích .NET Framework můžete nastavit úroveň naslouchacího procesu úpravou konfiguračního souboru pro vaši aplikaci. V tomto souboru můžete přidat naslouchací proces, nastavit jeho typ a nastavit jeho parametry, odebrat naslouchací proces nebo vymazat všechny naslouchací procesy dříve nastavené aplikací. Konfigurační soubor by měl být formátovaný jako v následujícím příkladu.

<configuration>  
    <system.diagnostics>  
        <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>  

Aby se tento příklad spustil, musíte zadat plně kvalifikovaný název sestavení. Informace o tom, jak získat plně kvalifikovaný název sestavení, naleznete v tématu Názvy sestavení.

Konstruktory

Vlastnosti

Metody

Platí pro

Viz také

• BaseFileName
• TraceData(TraceEventCache, String, TraceEventType, Int32, Object)
• TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)
• Flush()
• Close()
• Návod: Změna místa, kam objekt My.Application.Log zapisuje informace