EventLog.Log Egenskap

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

[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.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

Egenskapsvärde

Namnet på loggen. Det kan vara program, system, säkerhet eller ett anpassat loggnamn. Standardvärdet är en tom sträng ("").

Attribut

TypeConverterAttribute SettingsBindableAttribute

Exempel

I följande exempel läss poster i händelseloggen "NewEventLog" på den lokala datorn.

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

Kommentarer

Det finns som standard tre loggfiler på servern: Program, System och Säkerhet. Program och tjänster använder programloggfilen. Enhetsdrivrutiner använder systemloggfilen. Systemet genererar lyckade och misslyckade granskningshändelser i säkerhetsloggen när granskning aktiveras. Om du har andra program installerade, till exempel služba Active Directory på Windows servrar, kan det finnas andra standardloggfiler. Dessutom kan du skapa anpassade loggfiler på en lokal dator eller fjärrdator. Anpassade loggar hjälper dig att organisera dina poster på ett mer detaljerat sätt än vad som tillåts när komponenterna skriver händelser till standardprogramloggen.

Om du skriver till en händelselogg räcker det inte att ange Log egenskapen. Du måste associera en Source egenskap med händelseloggresursen för att ansluta den till en viss logg. Det är inte nödvändigt att ange en Source när endast läsning från en logg, men en händelsekälla måste associeras med händelseloggresursen i serverns register. Du kan bara ange namnet Log och MachineName (serverdatorns namn) som ska läsas från det.

Om egenskapen Source inte har angetts returnerar ett anrop till Log en tom sträng om Log den inte uttryckligen har angetts (genom att ange Log egenskapen eller via konstruktorn). Om har Source angetts Log returnerar namnet på den logg som källan registrerades till.

En källa kan bara registreras till en logg i taget. Om egenskapen Source har angetts för en instans av EventLogkan du inte ändra egenskapen för den Log utan att EventLog ändra värdet Source för eller anropa DeleteEventSource först. Om du ändrar Log egenskapen efter att egenskapen Source har angetts utlöser en loggpost ett undantag.

Operativsystemet lagrar händelseloggar som filer. När du använder EventLogInstaller eller CreateEventSource skapar en ny händelselogg lagras den associerade filen i katalogen %SystemRoot%\System32\Config på den angivna datorn. Filnamnet anges genom att de första 8 tecknen i Log egenskapen läggs till med filnamnstillägget ".evt".

Du kan inte skapa en ny logg med Log enbart egenskapen (utan att ange en källa för loggen). Du kan anropa CreateEventSource, skicka in ett nytt loggnamn som en parameter och sedan anropa DeleteEventSource. Avsikten är dock vanligtvis antingen att skapa (och skriva poster till) nya programspecifika loggar eller att läsa från befintliga loggar.

Om värdet Log ändras stängs händelseloggen och alla händelsereferenser släpps.

Se även

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