EventLog.Log Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Zdroj:

EventLog.cs

Získá nebo nastaví název protokolu pro čtení nebo zápis do.

public:
 property System::String ^ Log { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public string Log { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.Log : string with get, set

Public Property Log As String

Hodnota vlastnosti

String

Název protokolu. Může se jednat o název aplikace, systému, zabezpečení nebo vlastního názvu protokolu. Výchozí hodnota je prázdný řetězec ("").

Atributy

SettingsBindableAttribute

Příklady

Následující příklad přečte položky v protokolu událostí NewEventLog v místním počítači.

using System;
using System.Diagnostics;

class MySample{

    public static void Main(){

        EventLog myNewLog = new EventLog();
        myNewLog.Log = "NewEventLog";
        foreach(EventLogEntry entry in myNewLog.Entries){
            Console.WriteLine("\tEntry: " + entry.Message);
        }
    }
}

Imports System.Diagnostics

Class MySample
    Public Shared Sub Main()
        Dim myNewLog As New EventLog()
        myNewLog.Log = "NewEventLog"
        Dim entry As EventLogEntry
        For Each entry In  myNewLog.Entries
            Console.WriteLine((ControlChars.Tab & "Entry: " & entry.Message))
        Next entry
    End Sub
End Class

Poznámky

Na serveru existují ve výchozím nastavení tři soubory protokolu: aplikace, systém a zabezpečení. Aplikace a služby používají soubor protokolu aplikace. Ovladače zařízení používají soubor systémového protokolu. Systém generuje události auditu úspěchu a selhání v protokolu zabezpečení, když je auditování zapnuté. Pokud máte nainstalované jiné aplikace, například Active Directory na serverech s Windows, můžou existovat další výchozí soubory protokolu. Kromě toho můžete vytvořit vlastní soubory protokolu na místním nebo vzdáleném počítači. Vlastní protokoly pomáhají uspořádat položky podrobnějším způsobem, než je povoleno, když komponenty zapisují události do výchozího protokolu aplikace.

Poznámka:

Názvy protokolů jsou omezené na osm znaků. Podle systému jsou MyLogSample1 a MyLogSample2 stejný protokol.

Pokud zapíšete do protokolu událostí, nestačí zadat Log vlastnost. K prostředku protokolu událostí je nutné přidružit Source vlastnost, aby se připojila k určitému protokolu. Není nutné zadat Source při čtení pouze z protokolu, ale zdroj událostí musí být přidružen k prostředku protokolu událostí v registru serveru. Můžete zadat pouze Log název a MachineName (název počítače serveru), ze které se má číst.

Poznámka:

Pokud se připojujete k protokolu, nemusíte zadávat MachineName . Pokud neurčíte MachineName, předpokládá se místní počítač (".").

Source Pokud vlastnost nebyla zadána, volání, které Log vrátí prázdný řetězec, pokud Log nebyl explicitně nastaven (nastavením Log vlastnosti nebo prostřednictvím konstruktoru). Source Pokud byl zadán, vrátí název protokolu, Log ke kterému byl tento zdroj zaregistrován.

Zdroj lze najednou zaregistrovat pouze do jednoho protokolu. Source Pokud byla vlastnost nastavena pro instanci EventLog, nelze změnit Log vlastnost pro tuto EventLog vlastnost bez změny hodnoty Source nebo volání DeleteEventSource nejprve. Pokud změníte Log vlastnost po Source nastavení vlastnosti, při zápisu položky protokolu dojde k výjimce.

Operační systém ukládá protokoly událostí jako soubory. Pokud používáte EventLogInstaller nebo CreateEventSource vytváříte nový protokol událostí, přidružený soubor je uložen v adresáři %SystemRoot%\System32\Config v zadaném počítači. Název souboru je nastaven připojením prvních 8 znaků Log vlastnosti s příponou názvu souboru .evt.

Nelze vytvořit nový protokol pomocí Log samotné vlastnosti (bez zadání zdroje pro protokol). Můžete volat CreateEventSource, předat nový název protokolu jako parametr a pak volat DeleteEventSource. Záměrem je však obvykle vytvořit (a zapisovat položky) do nových protokolů specifických pro aplikaci nebo číst z existujících protokolů.

Pokud se Log hodnota změní, protokol událostí se zavře a všechny obslužné rutiny událostí se uvolní.

Upozornění

Pokud nastavíte Log vlastnost na název protokolu, který neexistuje, systém připojí EventLog protokol aplikace, ale ne varuje vás, že používá jiný protokol než ten, který jste zadali.

Viz také

• MachineName
• Source
• Entries
• Exists(String)
• Delete(String)
• CreateEventSource
• EventLogEntryCollection