A megvalósításhoz egy EventLog komponensre lesz szükségünk. Az új alkalmazás nyitása után a Toolbox – Components lapjáról tegyünk fel egy EventLog komponenst a Form-ra. Ez lesz az az objektum, melyen keresztül kezelhetjük a Windows eseménynaplóját.
Log
Osztály: System.Diagnostics.EventLog
public string Log {get; set;}
A komponens Log property-jénél választhatjuk ki, hogy melyik eseménynaplóra van szükségünk, mely az alábbiak egyike lehet:
- Application
- Security
- System
MachineName
Osztály: System.Diagnostics.EventLog
public string MachineName {get; set;}
A MachineName property-be annak a számítógépnek a neve kerül, melynek eseménynaplóját használni szeretnénk.
Megjegyzés
Ha e property-nek csak egy pontot tartalmazó sztringet adunk értékül, akkor az minden esetben a saját gépre vonatkozik.
Source
Osztály: System.Diagnostics.EventLog
public string Source {get; set;}
A Source property-ben kell megadnunk egy tetszőleges nevet. Ez a név kerül be az eseménynaplóba való íráskor a bejegyzés forrásaként.
WriteEntry
Osztály: System.Diagnostics.EventLog
public void WriteEntry(
string message
);
A property-ken keresztül megadott eseményt a WriteEntry függvény írja az eseménynaplóba.
Paraméterek
string message
A beírandó üzenet szövege.
WriteEntry
Osztály: System.Diagnostics.EventLog
public static void WriteEntry(
string source,
string message,
EventLogEntryType type,
int eventID,
short category,
byte[] rawData
);
A property-ken keresztül megadott eseményt a WriteEntry függvény írja az eseménynaplóba.
Paraméterek
string source
A Source paraméterben kell megadnunk egy tetszőleges nevet. Ez a név kerül be az eseménynaplóba való íráskor a bejegyzés forrásaként.
string message
A beírandó üzenet szövege.
EventLogEntryType type
A bejegyzés típusa. Ennek értéke az alábbiak egyike lehet:
- Error
- Warning
- Information
- FailureAudit
- SuccessAudit
int eventID
Egy tetszőleges számot írhatunk, mely az adott bejegyzésünkhöz kötődik. Általában az eseményünk azonosító számát szokás itt megadni.
short category
Egy tetszőleges számot írhatunk, mely az adott bejegyzésünkhöz kötődik. Általában az eseményünk kategóriájának számát szokás itt megadni.
byte[] rawData
RawData paraméterben egy tetszőleges bájtokat tartalmazó tömböt adhatunk át, mely szintén tárolásra kerül az eseménynaplóba.
A példaprogram
A property-k beállításai után, ha szeretnénk egy új bejegyzést elhelyezni az eseménynaplóba, akkor a WriteEntry függvényt használhatjuk, melynek több változata is létezik. A legegyszerűbb eset az, amikor csupán egy egyszerű sztringet adunk át. Ekkor ez sztring lesz az esemény szövege.
protected void button1_Click (object sender, System.EventArgs e)
{
eventLog1.WriteEntry(textBox1.Text);
}