EventLog.Log Właściwość

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.EventLog.dll

Pakiet:

System.Diagnostics.EventLog v8.0.0

Źródło:

EventLog.cs

Pobiera lub ustawia nazwę dziennika do odczytu lub zapisu.

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

Wartość właściwości

String

Nazwa dziennika. Może to być nazwa aplikacji, systemu, zabezpieczeń lub niestandardowego dziennika. Wartością domyślną jest ciąg pusty ("").

Atrybuty

SettingsBindableAttribute

Przykłady

Poniższy przykład odczytuje wpisy w dzienniku zdarzeń "NewEventLog" na komputerze lokalnym.

#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

Na serwerze istnieją domyślnie trzy pliki dziennika: aplikacja, system i zabezpieczenia. Aplikacje i usługi używają pliku dziennika aplikacji. Sterowniki urządzeń używają pliku dziennika systemu. System generuje zdarzenia inspekcji powodzenia i niepowodzenia w dzienniku zabezpieczeń po włączeniu inspekcji. Jeśli masz zainstalowane inne aplikacje, takie jak usługa Active Directory na serwerach z systemem Windows, mogą istnieć inne domyślne pliki dziennika. Ponadto można tworzyć niestandardowe pliki dziennika na komputerze lokalnym lub zdalnym. Dzienniki niestandardowe ułatwiają organizowanie wpisów w bardziej szczegółowy sposób niż jest dozwolone, gdy składniki zapisują zdarzenia w domyślnym dzienniku aplikacji.

Uwaga

Nazwy dzienników są ograniczone do ośmiu znaków. Zgodnie z systemem dziennik MyLogSample1 i MyLogSample2 są tym samym dziennikem.

Jeśli zapisujesz w dzienniku zdarzeń, nie wystarczy określić Log właściwość . Należy skojarzyć właściwość z zasobem Source dziennika zdarzeń, aby połączyć ją z określonym dziennikiem. Nie trzeba określać parametru Source tylko podczas odczytywania z dziennika, ale źródło zdarzeń musi być skojarzone z zasobem dziennika zdarzeń w rejestrze serwera. Można określić tylko Log nazwę i MachineName (nazwę komputera serwera), które mają być odczytywane z niego.

Uwaga

Nie musisz określać, MachineName czy łączysz się z dziennikiem. Jeśli nie określisz MachineName, zakłada się, że komputer lokalny (".").

Source Jeśli właściwość nie została określona, wywołanie Log metody zwraca pusty ciąg, jeśli Log nie zostało jawnie ustawione (przez ustawienie Log właściwości lub za pomocą konstruktora). Source Jeśli parametr został określony, zwraca nazwę dziennika, Log do którego zarejestrowano to źródło.

Źródło można zarejestrować tylko w jednym dzienniku jednocześnie. Source Jeśli właściwość została ustawiona dla wystąpienia EventLogklasy , nie można zmienić Log właściwości dla tej EventLog właściwości bez zmiany wartości Source lub wywołania DeleteEventSource najpierw. Jeśli zmienisz Log właściwość po Source ustawieniu właściwości, wpis dziennika zgłasza wyjątek.

System operacyjny przechowuje dzienniki zdarzeń jako pliki. Jeśli używasz polecenia EventLogInstaller lub CreateEventSource do tworzenia nowego dziennika zdarzeń, skojarzony plik jest przechowywany w katalogu %SystemRoot%\System32\Config na określonym komputerze. Nazwa pliku jest ustawiana przez dołączenie pierwszych 8 znaków Log właściwości z rozszerzeniem nazwy pliku ".evt".

Nie można utworzyć nowego dziennika przy użyciu Log samej właściwości (bez określania źródła dziennika). Można wywołać CreateEventSourcemetodę , przekazując nową nazwę dziennika jako parametr, a następnie wywołać metodę DeleteEventSource. Jednak intencją jest zwykle tworzenie (i zapisywanie wpisów) nowych dzienników specyficznych dla aplikacji lub odczytywanie z istniejących dzienników.

Log Jeśli wartość ulegnie zmianie, dziennik zdarzeń zostanie zamknięty i zostaną zwolnione wszystkie dojścia zdarzeń.

Przestroga

Jeśli ustawisz Log właściwość na nazwę dziennika, który nie istnieje, system dołącza EventLog element do dziennika aplikacji, ale nie ostrzega o tym, że używa dziennika innego niż określony przez Ciebie.

Zobacz też

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