EventLog.Log Vlastnost

Definice

Obor názvů:

System.Diagnostics

Sestavení:

System.Diagnostics.EventLog.dll

Balíček:

System.Diagnostics.EventLog v8.0.0

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 to být 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 čte položky v protokolu událostí NewEventLog v místním počítači.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
int main()
{
   EventLog^ myNewLog = gcnew EventLog;
   myNewLog->Log = "NewEventLog";
   System::Collections::IEnumerator^ myEnum = myNewLog->Entries->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      EventLogEntry^ entry = safe_cast<EventLogEntry^>(myEnum->Current);
      Console::WriteLine( "\tEntry: {0}", entry->Message );
   }
}

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 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 aplikačního protokolu.

Poznámka

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

Pokud zapisujete do protokolu událostí, nestačí zadat Log vlastnost. Abyste ji mohli připojit ke konkrétnímu Source protokolu, musíte k prostředku protokolu událostí přidružit vlastnost. Není nutné zadávat Source hodnotu 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), který se z něj má číst.

Poznámka

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

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

Zdroj je možné zaregistrovat pouze do jednoho protokolu najednou. Source Pokud byla vlastnost nastavena pro instanci EventLognástroje , nelze změnit Log vlastnost pro EventLog tuto instanci bez změny hodnoty Source nebo bez volání DeleteEventSource nejprve. Pokud změníte Log vlastnost po Source nastavení vlastnosti, zápis položky protokolu vyvolá výjimku.

Operační systém ukládá protokoly událostí jako soubory. Při použití EventLogInstaller nebo CreateEventSource k vytvoření nového protokolu událostí je přidružený soubor uložen v adresáři %SystemRoot%\System32\Config v zadaném počítači. Název souboru se nastaví připojením prvních 8 znaků Log vlastnosti s příponou názvu souboru ".evt".

Nový protokol nelze vytvořit pouze pomocí Log 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 buď vytvořit (a zapsat položky) nové protokoly specifické pro aplikaci, nebo číst z existujících protokolů.

Pokud se Log hodnota změní, protokol událostí se zavře a všechny popisovače událostí se uvolní.

Upozornění

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

Viz také

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