FileLogTraceListener Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Poskytuje jednoduchý naslouchací proces, který směruje výstup protokolování do souboru.
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 TraceListenerPublic Class FileLogTraceListener
Inherits TraceListener- Dědičnost
- Atributy
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:
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
baseNameje základní název protokolu určený BaseFileName vlastností.Část
dateStampmá formát "RRRR-MM-DD" a zobrazí se, když LogFileCreationSchedule je Daily nebo Weekly.Pokud je se stejným
baseNamesouborem protokolu potřeba více než jeden soubor protokolu adateStamp,versionpřidá se k názvu souboru část, kladnáInteger.
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.
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:DEBUGpříznak do příkazového řádku kompilátoru při kompilaci kódu nebo můžete přidat#define DEBUGna začátek souboru. V jazyce Visual Basic přidejte/d:DEBUG=Truepříznak do příkazového řádku kompilátoru.Pokud chcete povolit trasování v jazyce C#, přidejte
/d:TRACEpříznak do příkazového řádku kompilátoru při kompilaci kódu nebo přidejte#define TRACEdo horní části souboru. V jazyce Visual Basic přidejte/d:TRACE=Truepří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
| FileLogTraceListener() |
Inicializuje novou instanci FileLogTraceListener třídy s výchozím názvem. |
| FileLogTraceListener(String) |
Inicializuje novou instanci FileLogTraceListener třídy se zadaným názvem. |
Vlastnosti
| Append |
Určuje, zda se má výstup připojit k aktuálnímu souboru nebo ho zapsat do nového nebo existujícího souboru. |
| Attributes |
Získá vlastní atributy trasovacího naslouchacího procesu definované v konfiguračním souboru aplikace. (Zděděno od TraceListener) |
| AutoFlush |
Určuje, jestli zápis do datového proudu souboru protokolu vyprázdní vyrovnávací paměť. |
| BaseFileName |
Získá nebo nastaví základní název pro soubory protokolu, který se používá k vytvoření úplného názvu souboru protokolu. |
| CustomLocation |
Získá nebo nastaví adresář souboru protokolu, když Location je vlastnost nastavena na Custom. |
| Delimiter |
Získá nebo nastaví oddělovač použitý k oddělení polí v protokolu zprávy. |
| DiskSpaceExhaustedBehavior |
Určuje, co dělat při zápisu do souboru protokolu a je k dispozici méně volného místa na disku, než určuje ReserveDiskSpace vlastnost. |
| Encoding |
Získá nebo nastaví kódování použít při vytváření nového souboru protokolu. |
| Filter |
Získá nebo nastaví filtr trasování pro trasovací naslouchací proces. (Zděděno od TraceListener) |
| FullLogFileName |
Získá aktuální úplný název souboru protokolu. |
| IncludeHostName |
Určuje, jestli má být do výstupu zahrnut název hostitele počítače pro protokolování. |
| IndentLevel |
Získá nebo nastaví úroveň odsazení. (Zděděno od TraceListener) |
| IndentSize |
Získá nebo nastaví počet mezer v odsazení. (Zděděno od TraceListener) |
| IsThreadSafe |
Získá hodnotu označující, zda trasovací naslouchací proces je bezpečný z více vláken. (Zděděno od TraceListener) |
| Location |
Získá nebo nastaví umístění pro soubory protokolu. |
| LogFileCreationSchedule |
Určuje, které datum se má zahrnout do názvů souborů protokolu. |
| MaxFileSize |
Získá nebo nastaví maximální povolenou velikost souboru protokolu v bajtech. |
| Name |
Získá nebo nastaví název pro tento TraceListener. (Zděděno od TraceListener) |
| NeedIndent |
Získá nebo nastaví hodnotu označující, zda odsadit výstup. (Zděděno od TraceListener) |
| ReserveDiskSpace |
Získá nebo nastaví množství volného místa na disku v bajtech, které je nutné před zápisem zpráv do souboru protokolu. |
| TraceOutputOptions |
Získá nebo nastaví možnosti výstupu trasování. (Zděděno od TraceListener) |
Metody
| Close() |
Zavře podkladový datový proud pro aktuální soubor protokolu a uvolní všechny prostředky přidružené k aktuálnímu datovému proudu. |
| CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject) |
| Dispose() |
Uvolní všechny prostředky používané nástrojem TraceListener. (Zděděno od TraceListener) |
| Dispose(Boolean) |
Zavře podkladový datový proud a volitelně uvolní spravované prostředky. |
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| Fail(String) |
Vygeneruje chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| Fail(String, String) |
Vygeneruje chybovou zprávu a podrobnou chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| Flush() |
Vyprázdní podkladový datový proud, který zapisuje do aktuálního souboru protokolu. |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetLifetimeService() |
Zastaralé.
Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| GetSupportedAttributes() |
Získá vlastní atributy konfigurace XML podporované trasovacím naslouchacím procesem. |
| GetType() |
Získá aktuální Type instanci. (Zděděno od Object) |
| InitializeLifetimeService() |
Zastaralé.
Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| MemberwiseClone(Boolean) |
Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject) |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Zapíše trasovací informace, datový objekt a informace o událostech do výstupního souboru nebo datového proudu. |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Zapíše trasovací informace, pole datových objektů a informace o událostech do výstupního souboru nebo datového proudu. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Zapíše trasování a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Zapíše trasovací informace, zprávu a informace o událostech do výstupního souboru nebo datového proudu. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Zapíše trasovací informace, formátovanou matici objektů a informace o událostech do výstupního souboru nebo datového proudu. |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Zapíše trasovací informace, zprávu, související identitu aktivity a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener) |
| Write(Object) |
Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| Write(Object, String) |
Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| Write(String) |
Zapíše doslovnou zprávu na disk bez dalších kontextových informací. |
| Write(String, String) |
Zapíše název kategorie a zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| WriteIndent() |
Zapíše odsazení do naslouchacího procesu, který vytvoříte při implementaci této třídy, a resetuje NeedIndent vlastnost na |
| WriteLine(Object) |
Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener) |
| WriteLine(Object, String) |
Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener) |
| WriteLine(String) |
Zapíše doslovnou zprávu na disk následovanou aktuálním ukončovačem řádku bez jakýchkoli dalších kontextových informací. |
| WriteLine(String, String) |
Zapíše název kategorie a zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener) |
Platí pro
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro