EventLog.Log Właściwość

Definicja

Przestrzeń nazw:

System.Diagnostics

Zestaw:

System.Diagnostics.EventLog.dll

Ź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 niestandardowej nazwy dziennika. Wartość domyślna to pusty ciąg ("").

Atrybuty

SettingsBindableAttribute

Przykłady

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

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 / Notatka

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ść . Aby połączyć go z określonym dziennikiem, należy skojarzyć Source właściwość z zasobem dziennika zdarzeń. Nie jest konieczne określenie parametru Source podczas odczytu tylko 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.

Uwaga / Notatka

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

Source Jeśli właściwość nie została określona, wywołanie Log funkcji 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, zapis wpisu dziennika zgłasza wyjątek.

System operacyjny przechowuje dzienniki zdarzeń jako pliki. W przypadku użycia EventLogInstaller lub CreateEventSource utworzenia 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żesz wywołać CreateEventSourcemetodę , przekazując nową nazwę dziennika jako parametr, a następnie wywołać metodę DeleteEventSource. Jednak intencją jest zazwyczaj utworzenie (i zapisanie wpisów) nowych dzienników specyficznych dla aplikacji lub odczyt z istniejących dzienników.

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

Ostrzeżenie

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, że używa dziennika innego niż określony.

Zobacz też

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