EventLog.Log Eigenschap

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

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

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }

[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }

[System.ComponentModel.SettingsBindable(true)]
[System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string Log { get; set; }

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

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set

[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
[<System.ComponentModel.TypeConverter("System.Diagnostics.Design.LogConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.Log : string with get, set

Public Property Log As String

Waarde van eigenschap

De naam van het logboek. Dit kan een toepassing, systeem, beveiliging of een aangepaste logboeknaam zijn. De standaardwaarde is een lege tekenreeks ("").

Kenmerken

SettingsBindableAttribute TypeConverterAttribute

Voorbeelden

In het volgende voorbeeld worden vermeldingen gelezen in het gebeurtenislogboek, 'NewEventLog', op de lokale computer.

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

Opmerkingen

Er bestaan standaard drie logboekbestanden op de server: Toepassing, Systeem en Beveiliging. Toepassingen en services maken gebruik van het toepassingslogboekbestand. Apparaatstuurprogramma's gebruiken het logboekbestand van het systeem. Het systeem genereert geslaagde en mislukte controlegebeurtenissen in het beveiligingslogboek wanneer controle is ingeschakeld. Als er andere toepassingen zijn geïnstalleerd, zoals Active Directory op Windows servers, zijn er mogelijk andere standaardlogboekbestanden. Daarnaast kunt u aangepaste logboekbestanden maken op een lokale of externe computer. Met aangepaste logboeken kunt u uw items op een gedetailleerdere manier ordenen dan is toegestaan wanneer uw onderdelen gebeurtenissen naar het standaardtoepassingslogboek schrijven.

Als u naar een gebeurtenislogboek schrijft, is het niet voldoende om de Log eigenschap op te geven. U moet een Source eigenschap koppelen aan uw gebeurtenislogboekresource om deze te verbinden met een bepaald logboek. Het is niet nodig om een Source gebeurtenisbron op te geven wanneer deze alleen wordt gelezen uit een logboek, maar een gebeurtenisbron moet worden gekoppeld aan de gebeurtenislogboekresource in het register van de server. U kunt alleen de Log naam en MachineName (servercomputernaam) opgeven waaruit deze moet worden gelezen.

Als de Source eigenschap niet is opgegeven, retourneert een aanroep om een lege tekenreeks te retourneren als Log deze niet expliciet is ingesteld (door de Log eigenschap of via de constructor in te Log stellen). Als de Source bron is opgegeven, Log retourneert u de naam van het logboek waarnaar die bron is geregistreerd.

Een bron kan slechts worden geregistreerd bij één logboek tegelijk. Als de Source eigenschap is ingesteld voor een exemplaar van EventLog, kunt u de Log eigenschap hiervoor EventLog niet wijzigen zonder eerst de waarde van Source of aanroepen DeleteEventSource te wijzigen. Als u de Log eigenschap wijzigt nadat de Source eigenschap is ingesteld, genereert het schrijven van een logboekvermelding een uitzondering.

In het besturingssysteem worden gebeurtenislogboeken opgeslagen als bestanden. Wanneer u een nieuw gebeurtenislogboek gebruikt EventLogInstaller of CreateEventSource maakt, wordt het bijbehorende bestand opgeslagen in de %SystemRoot%map \System32\Config op de opgegeven computer. De bestandsnaam wordt ingesteld door de eerste 8 tekens van de Log eigenschap toe te voegen met de bestandsnaamextensie .evt.

U kunt geen nieuw logboek maken met behulp van de Log eigenschap alleen (zonder een bron voor het logboek op te geven). U kunt een nieuwe logboeknaam als parameter aanroepen CreateEventSourceen vervolgens aanroepen DeleteEventSource. De bedoeling is echter meestal om nieuwe toepassingsspecifieke logboeken te maken (en te schrijven naar) of om uit bestaande logboeken te lezen.

Als de Log waarde verandert, wordt het gebeurtenislogboek gesloten en worden alle gebeurtenis-ingangen vrijgegeven.

Zie ook

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