EventLog.Log Özellik

Tanım

Okunacak veya yazacak günlüğün adını alır veya ayarlar.

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.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
Public Property Log As String

Özellik Değeri

Günlüğün adı. Bu Uygulama, Sistem, Güvenlik veya özel bir günlük adı olabilir. Varsayılan değer, boş dizedir ("").

Öznitelikler

Örnekler

Aşağıdaki örnek, yerel bilgisayardaki "NewEventLog" olay günlüğündeki girdileri okur.

#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

Açıklamalar

Sunucuda varsayılan olarak üç günlük dosyası vardır: Uygulama, Sistem ve Güvenlik. Uygulamalar ve hizmetler, Uygulama günlük dosyasını kullanır. Cihaz sürücüleri Sistem günlük dosyasını kullanır. Sistem, denetim açıkken Güvenlik günlüğünde başarı ve başarısızlık denetim olayları oluşturur. Windows sunucularında Active Directory gibi başka uygulamalarınız yüklüyse, başka varsayılan günlük dosyaları olabilir. Ayrıca, yerel veya uzak bir bilgisayarda özel günlük dosyaları oluşturabilirsiniz. Özel günlükler, bileşenlerinizin varsayılan Uygulama günlüğüne olay yazmasına izin verilenden daha ayrıntılı bir şekilde girişlerinizi düzenlemenize yardımcı olur.

Not

Günlük adları sekiz karakterle sınırlıdır. Sisteme göre MyLogSample1 ve MyLogSample2 aynı günlüklerdir.

Bir olay günlüğüne yazarsanız, özelliğini belirtmek Log yeterli değildir. Bir özelliği belirli bir Source günlüğe bağlamak için olay günlüğü kaynağınızla ilişkilendirmeniz gerekir. Yalnızca bir günlükten okurken belirtilmesi Source gerekmez, ancak bir olay kaynağı sunucunun kayıt defterindeki olay günlüğü kaynağıyla ilişkilendirilmelidir. Yalnızca okunacak adı ve MachineName (sunucu bilgisayar adı) belirtebilirsinizLog.

Not

Bir günlüğe bağlanıyorsanız değerini belirtmeniz MachineName gerekmez. belirtmezseniz MachineName, yerel bilgisayar (".") varsayılır.

Source Özellik belirtilmemişse, açıkça ayarlanmamışsa Log (özelliği ayarlayarak Log veya oluşturucu aracılığıyla) için çağrısı Log boş bir dize döndürür. Source belirtildiyse, Log kaynağın kaydedildiği günlüğün adını döndürür.

Bir kaynak aynı anda yalnızca bir günlüğe kaydedilebilir. Source özelliği bir örneği EventLogiçin ayarlandıysa, değerini değiştirmeden Log veya önce çağırmadan DeleteEventSource özelliğini EventLog değiştiremezsinizSource. Özellik ayarlandıktan sonra özelliği değiştirirseniz Log , günlük girdisi yazıldıktan sonra Source bir özel durum oluşturulur.

İşletim sistemi olay günlüklerini dosya olarak depolar. veya CreateEventSource kullanarak EventLogInstaller yeni bir olay günlüğü oluşturduğunuzda, ilişkili dosya belirtilen bilgisayardaki %SystemRoot%\System32\Config dizininde depolanır. Dosya adı, özelliğin ilk 8 karakteri Log ".evt" dosya adı uzantısıyla eklenerek ayarlanır.

Tek başına özelliğini kullanarak Log yeni bir günlük oluşturamazsınız (günlük için bir kaynak belirtmeden). parametresi olarak yeni bir günlük adı geçirerek çağrısı yapabilir ve ardından çağrısı DeleteEventSourceyapabilirsinizCreateEventSource. Ancak amaç genellikle uygulamaya özgü yeni günlükler oluşturmak (ve bu günlüklere girdi yazmak) veya mevcut günlüklerden okumaktır.

Log Değer değişirse, olay günlüğü kapatılır ve tüm olay tanıtıcıları serbest bırakılır.

Dikkat

Özelliği var olmayan bir günlüğün adına ayarlarsanız Log , sistem öğesini Uygulama günlüğüne ekler EventLog , ancak belirttiğinizden başka bir günlük kullandığı konusunda sizi uyarmaz.

Şunlara uygulanır

Ayrıca bkz.