EventLog.Log Właściwość

Definicja

Pobiera lub ustawia nazwę dziennika do odczytu lub zapisu.Gets or sets the name of the log to read from or write to.

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

Wartość właściwości

String

Nazwa dziennika.The name of the log. Może to być aplikacja, system, zabezpieczenia lub nazwa dziennika niestandardowego.This can be Application, System, Security, or a custom log name. Wartością domyślną jest ciąg pusty ("").The default is an empty string ("").

Atrybuty

Przykłady

Poniższy przykład odczytuje wpisy w dzienniku zdarzeń "NewEventLog" na komputerze lokalnym.The following example reads entries in the event log, "NewEventLog", on the local computer.

#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

Uwagi

Trzy pliki dziennika są domyślnie dostępne na serwerze: aplikacja, system i zabezpieczenia.Three log files exist by default on the server: Application, System, and Security. Aplikacje i usługi korzystają z pliku dziennika aplikacji.Applications and services use the Application log file. Sterowniki urządzeń używają pliku dziennika systemowego.Device drivers use the System log file. System generuje zdarzenia o powodzeniu i niepowodzeniu inspekcji w dzienniku zabezpieczeń, gdy inspekcja jest włączona.The system generates success and failure audit events in the Security log when auditing is turned on. Jeśli masz zainstalowane inne aplikacje, takie jak Active Directory na serwerach z systemem Windows, mogą istnieć inne domyślne pliki dziennika.If you have other applications installed, like Active Directory on Windows servers, there might be other default log files. Ponadto można tworzyć niestandardowe pliki dziennika na komputerze lokalnym lub zdalnym.In addition, you can create custom log files on a local or remote computer. Dzienniki niestandardowe ułatwiają organizowanie wpisów w bardziej szczegółowy sposób, niż jest to dozwolone, gdy składniki zapisują zdarzenia do domyślnego dziennika aplikacji.Custom logs help organize your entries in a more detailed way than is allowed when your components write events to the default Application log.

Uwaga

Nazwy dzienników są ograniczone do ośmiu znaków.Log names are limited to eight characters. Zgodnie z systemem MyLogSample1 i MyLogSample2 są tego samego dziennika.According to the system, MyLogSample1 and MyLogSample2 are the same log.

Jeśli zapisujesz dane w dzienniku zdarzeń, nie jest wystarczające, aby określić Log Właściwość.If you write to an event log, it is not enough to specify the Log property. Należy skojarzyć Source Właściwość z zasobem dziennika zdarzeń, aby połączyć ją z określonym dziennikiem.You must associate a Source property with your event log resource to connect it to a particular log. Nie trzeba określać w Source przypadku odczytywania danych z dziennika, ale Źródło zdarzenia musi być skojarzone z zasobem dziennika zdarzeń w rejestrze serwera.It is not necessary to specify a Source when only reading from a log, but an event source must be associated with the event log resource in the server's registry. Można określić tylko Log nazwę i MachineName (nazwę komputera serwera) do odczytania.You can specify only the Log name and MachineName (server computer name) to read from it.

Uwaga

Nie jest wymagane, aby określić, MachineName czy łączysz się z dziennikiem.You are not required to specify the MachineName if you are connecting to a log. Jeśli nie określisz MachineName , zostanie przyjęty komputer lokalny (".").If you do not specify the MachineName, the local computer (".") is assumed.

Jeśli Source Właściwość nie została określona, wywołanie do Log zwraca pusty ciąg, jeśli Log nie został jawnie ustawiony (przez ustawienie Log właściwości lub przez konstruktora).If the Source property has not been specified, a call to Log returns an empty string if Log has not been explicitly set (by setting the Log property, or through the constructor). Jeśli Source określono, Log zwraca nazwę dziennika, do którego zostało zarejestrowane to źródło.If the Source has been specified, Log returns the name of the log to which that source was registered.

Źródło może być rejestrowane tylko w jednym dzienniku naraz.A source can only be registered to one log at a time. Jeśli Source Właściwość została ustawiona dla wystąpienia elementu EventLog , nie można zmienić Log właściwości dla tego elementu EventLog bez zmiany wartości Source lub wywołania DeleteEventSource pierwszej.If the Source property was set for an instance of EventLog, you cannot change the Log property for that EventLog without changing the value of Source or calling DeleteEventSource first. Jeśli zmienisz Log Właściwość po Source ustawieniu właściwości, napisanie wpisu dziennika zgłasza wyjątek.If you change the Log property after the Source property has been set, writing a log entry throws an exception.

System operacyjny przechowuje dzienniki zdarzeń jako pliki.The operating system stores event logs as files. W przypadku użycia EventLogInstaller CreateEventSource programu lub do utworzenia nowego dziennika zdarzeń skojarzony plik jest przechowywany w katalogu%SystemRoot%\System32\Config na określonym komputerze.When you use EventLogInstaller or CreateEventSource to create a new event log, the associated file is stored in the %SystemRoot%\System32\Config directory on the specified computer. Nazwa pliku jest ustawiana przez dołączenie pierwszych 8 znaków Log właściwości z rozszerzeniem nazwy pliku ". evt".The file name is set by appending the first 8 characters of the Log property with the ".evt" file name extension.

Nie można utworzyć nowego dziennika, używając Log samego właściwości (bez określania źródła dziennika).You cannot create a new log using the Log property alone (without specifying a source for the log). Można wywołać CreateEventSource , przekazać w nowej nazwie dziennika jako parametr, a następnie wywołać metodę DeleteEventSource .You can call CreateEventSource, passing in a new log name as a parameter, and then call DeleteEventSource. Jednak zamiarem jest zazwyczaj utworzenie (i zapisanie wpisów do) nowych dzienników specyficznych dla aplikacji lub odczyt z istniejących dzienników.However, the intent is usually either to create (and write entries to) new application-specific logs, or to read from existing logs.

Jeśli Log wartość ulegnie zmianie, dziennik zdarzeń zostanie zamknięty i zostaną wydane wszystkie uchwyty zdarzeń.If the Log value changes, the event log is closed and all event handles are released.

Przestroga

Jeśli ustawisz Log Właściwość na nazwę dziennika, który nie istnieje, system dołączy EventLog do dziennika aplikacji, ale nie ostrzega o tym, że używa dziennika innego niż określony.If you set the Log property to the name of a log that does not exist, the system attaches the EventLog to the Application log, but does not warn you that it is using a log other than the one you specified.

Dotyczy

Zobacz też