EventLog.Log Properti

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Diagnostics.EventLog.dll

Paket:

System.Diagnostics.EventLog v8.0.0

Sumber:

EventLog.cs

Mendapatkan atau mengatur nama log untuk dibaca dari atau ditulis.

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

Nilai Properti

String

Nama log. Ini bisa berupa Aplikasi, Sistem, Keamanan, atau nama log kustom. Defaultnya adalah string kosong ("").

Atribut

SettingsBindableAttribute

Contoh

Contoh berikut membaca entri dalam log peristiwa, "NewEventLog", di komputer lokal.

#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

Keterangan

Ada tiga file log secara default di server: Aplikasi, Sistem, dan Keamanan. Aplikasi dan layanan menggunakan file log Aplikasi. Driver perangkat menggunakan file log Sistem. Sistem menghasilkan peristiwa audit keberhasilan dan kegagalan di log Keamanan saat audit diaktifkan. Jika Anda memiliki aplikasi lain yang terinstal, seperti Direktori Aktif di server Windows, mungkin ada file log default lainnya. Selain itu, Anda dapat membuat file log kustom di komputer lokal atau jarak jauh. Log kustom membantu mengatur entri Anda dengan cara yang lebih rinci daripada yang diizinkan saat komponen Anda menulis peristiwa ke log Aplikasi default.

Catatan

Nama log dibatasi hingga delapan karakter. Menurut sistem, MyLogSample1 dan MyLogSample2 adalah log yang sama.

Jika Anda menulis ke log peristiwa, tidak cukup untuk menentukan Log properti . Anda harus mengaitkan Source properti dengan sumber daya log peristiwa Anda untuk menyambungkannya ke log tertentu. Tidak perlu menentukan Source kapan hanya membaca dari log, tetapi sumber peristiwa harus dikaitkan dengan sumber daya log peristiwa di registri server. Anda hanya Log dapat menentukan nama dan MachineName (nama komputer server) untuk dibaca darinya.

Catatan

Anda tidak diharuskan untuk menentukan MachineName apakah Anda menyambungkan ke log. Jika Anda tidak menentukan MachineName, komputer lokal (".") diasumsikan.

Source Jika properti belum ditentukan, panggilan untuk Log mengembalikan string kosong jika Log belum diatur secara eksplisit (dengan mengatur Log properti , atau melalui konstruktor). Source Jika telah ditentukan, Log mengembalikan nama log tempat sumber tersebut didaftarkan.

Sumber hanya dapat didaftarkan ke satu log pada satu waktu. Source Jika properti diatur untuk instans EventLog, Anda tidak dapat mengubah Log properti untuk itu EventLog tanpa mengubah nilai atau memanggil DeleteEventSource terlebih Source dahulu. Jika Anda mengubah Log properti setelah Source properti diatur, menulis entri log akan menampilkan pengecualian.

Sistem operasi menyimpan log peristiwa sebagai file. Ketika Anda menggunakan EventLogInstaller atau CreateEventSource untuk membuat log kejadian baru, file terkait disimpan di direktori %SystemRoot%\System32\Config pada komputer yang ditentukan. Nama file diatur dengan menambahkan 8 karakter Log pertama properti dengan ekstensi nama file ".evt".

Anda tidak dapat membuat log baru menggunakan Log properti saja (tanpa menentukan sumber untuk log). Anda dapat memanggil CreateEventSource, meneruskan nama log baru sebagai parameter, lalu memanggil DeleteEventSource. Namun, niatnya biasanya untuk membuat (dan menulis entri ke) log khusus aplikasi baru, atau membaca dari log yang ada.

Log Jika nilai berubah, log peristiwa ditutup dan semua penanganan peristiwa dirilis.

Perhatian

Jika Anda mengatur Log properti ke nama log yang tidak ada, sistem melampirkan EventLog ke log Aplikasi, tetapi tidak memperingatkan Anda bahwa properti tersebut menggunakan log selain yang Anda tentukan.

Lihat juga

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