EventLog Sınıf

Tanım

public ref class EventLog : System::ComponentModel::Component, System::ComponentModel::ISupportInitialize

public class EventLog : System.ComponentModel.Component, System.ComponentModel.ISupportInitialize

type EventLog = class
    inherit Component
    interface ISupportInitialize

Public Class EventLog
Inherits Component
Implements ISupportInitialize

Devralma

Object

MarshalByRefObject

Component

EventLog

Uygulamalar

ISupportInitialize

Örnekler

Aşağıdaki örnek, henüz yoksa olay kaynağını MySource oluşturur ve olay günlüğüne MyNewLogbir giriş yazar.

#using <System.dll>

using namespace System;
using namespace System::Diagnostics;
using namespace System::Threading;
int main()
{
   
   // Create the source, if it does not already exist.
   if (  !EventLog::SourceExists( "MySource" ) )
   {
      //An event log source should not be created and immediately used.
      //There is a latency time to enable the source, it should be created
      //prior to executing the application that uses the source.
      //Execute this sample a second time to use the new source.
      EventLog::CreateEventSource( "MySource", "MyNewLog" );
      Console::WriteLine( "CreatingEventSource" );
      // The source is created.  Exit the application to allow it to be registered.
      return 0;
   }

   
   // Create an EventLog instance and assign its source.
   EventLog^ myLog = gcnew EventLog;
   myLog->Source = "MySource";
   
   // Write an informational entry to the event log.    
   myLog->WriteEntry( "Writing to event log." );
}

using System;
using System.Diagnostics;
using System.Threading;

class MySample{

    public static void Main(){

        // Create the source, if it does not already exist.
        if(!EventLog.SourceExists("MySource"))
        {
             //An event log source should not be created and immediately used.
             //There is a latency time to enable the source, it should be created
             //prior to executing the application that uses the source.
             //Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog");
            Console.WriteLine("CreatedEventSource");
            Console.WriteLine("Exiting, execute the application a second time to use the source.");
            // The source is created.  Exit the application to allow it to be registered.
            return;
        }

        // Create an EventLog instance and assign its source.
        EventLog myLog = new EventLog();
        myLog.Source = "MySource";

        // Write an informational entry to the event log.
        myLog.WriteEntry("Writing to event log.");
    }
}

Option Explicit
Option Strict

Imports System.Diagnostics
Imports System.Threading

Class MySample
    Public Shared Sub Main()
        
        If Not EventLog.SourceExists("MySource") Then
            ' Create the source, if it does not already exist.
            ' An event log source should not be created and immediately used.
            ' There is a latency time to enable the source, it should be created
            ' prior to executing the application that uses the source.
            ' Execute this sample a second time to use the new source.
            EventLog.CreateEventSource("MySource", "MyNewLog")
            Console.WriteLine("CreatingEventSource")
            'The source is created.  Exit the application to allow it to be registered.
            Return
        End If
        
        ' Create an EventLog instance and assign its source.
        Dim myLog As New EventLog()
        myLog.Source = "MySource"
        
        ' Write an informational entry to the event log.    
        myLog.WriteEntry("Writing to event log.")
    End Sub
End Class

Açıklamalar

EventLog , önemli yazılım veya donanım olayları hakkındaki bilgileri kaydeden Windows olay günlüklerine erişmenizi veya bu günlükleri özelleştirmenizi sağlar. kullanarak EventLogmevcut günlüklerden okuyabilir, günlüklere girdi yazabilir, olay kaynakları oluşturabilir veya silebilir, günlükleri silebilir ve günlük girişlerini yanıtlayabilirsiniz. Olay kaynağı oluştururken yeni günlükler de oluşturabilirsiniz.

sınıfı, tek tek olay günlüklerine ve girişlerine erişim sağlamaya ek olarak tüm EventLog olay günlüklerinin koleksiyonuna erişmenizi sağlar. üyelerini staticEventLog kullanarak günlükleri silebilir, günlük listelerini alabilir, kaynak oluşturabilir veya silebilir ya da bir bilgisayarın zaten belirli bir kaynak içerdiğini belirleyebilirsiniz.

Üç varsayılan olay günlüğü vardır: Uygulama, Sistem ve Güvenlik. Güvenlik günlüğü salt okunurdur. Active Directory gibi yüklediğiniz diğer uygulama ve hizmetlerin ek olay günlükleri olabilir.

sınıfı kullanılırken EventLog güvenlikle ilgili dikkat edilmesi gerekenler vardır. EventLog.NET Framework 2.0 ve sonraki sürümlerinde belirli eylemler için izinler EventLogPermission veya .NET Framework 1.0 ve 1.1'e tam güven gerektirir. Kısmen güvenilen koda verilmemesi önerilir EventLogPermission . Ve EventLogEntry nesneleri de dahil olmak üzere EventLogEntryCollection hiçbir olay günlüğü nesnesini daha az güvenilen koda geçirmemelisiniz. Örneğin, bir EventLog nesne oluşturmak, girdi yazmak ve sonra nesneyi kısmen güvenilen koda geçirmek EventLog bir güvenlik sorunu oluşturabilir, çünkü olay günlüğüne okuma ve yazma özelliği kodun başka bir uygulama adına olay günlüğü iletileri verme gibi eylemleri gerçekleştirmesine olanak tanır.

Windows Vista'dan başlayarak, Kullanıcı Hesabı Denetimi (UAC) bir kullanıcının kimlik bilgilerini belirler. Yerleşik Yöneticiler grubunun bir üyesi iseniz, size iki çalışma zamanı erişim belirteci atanır: Standart kullanıcı erişim belirteci ve yönetici erişim belirteci. Varsayılan olarak, standart kullanıcı rolünde olursunuz. Güvenlik günlüğüne erişen kodu çalıştırmak için önce kimlik bilgilerinizi standart kullanıcıdan yöneticiye yükseltmeniz gerekir. Bir uygulamayı başlattığınızda, uygulamanın kısayol menüsünü açarak (fare kullanıyorsanız uygulama simgesine sağ tıklayın) ve yönetici olarak çalıştırmak istediğinizi belirterek bunu yapabilirsiniz.

EventLog kullanarak sunucunun Olay Görüntüleyicisi görüntüleyebileceğiniz özel olay günlükleri oluşturabilirsiniz. RegisterDisplayName Olay Görüntüleyicisi olay günlüğünüz için yerelleştirilmiş bir ad görüntülemek için yöntemini kullanın. Olay günlüğünüzün ModifyOverflowPolicy maksimum günlük boyutuna ulaştığında davranışını yapılandırmak için yöntemini kullanın.

Bir olay günlüğünden okumak için günlük adını (Log özellik) ve sunucu bilgisayar adını (MachineName olay günlüğü için özellik) belirtin. Sunucu bilgisayar adını belirtmezseniz yerel bilgisayar olan "." varsayılır. Olay kaynağının (Source özelliğinin) belirtilmesi gerekmez, çünkü bir kaynak yalnızca günlüklere yazmak için gereklidir. Entries özelliği, olay günlüğünün girdi listesiyle otomatik olarak doldurulur.

Bir olay günlüğüne yazmak için bir olay kaynağı (Source özelliği) belirtin veya oluşturun. Yeni bir olay kaynağı oluşturmak için bilgisayarda yönetici kimlik bilgileriniz olmalıdır. Olay kaynağı uygulamanızı geçerli bir girdi kaynağı olarak olay günlüğüne kaydeder. Olay kaynağını kullanarak bir kerede yalnızca bir günlüğe yazabilirsiniz. Source özelliği herhangi bir rastgele dize olabilir, ancak ad bilgisayardaki diğer kaynaklardan farklı olmalıdır. Olay kaynağı genellikle uygulamanın adı veya başka bir tanımlayıcı dizedir. Yinelenen Source bir değer oluşturulmaya çalışılırken özel durum oluşturulur. Ancak, tek bir olay günlüğü birden çok kaynakla ilişkilendirilebilir.

Örnekle EventLog ilişkilendirilmiş olay günlüğü için olay kaynağı yoksa yeni bir olay kaynağı oluşturulur. Windows Vista ve sonraki sürümlerde veya Windows Server 2003'te olay kaynağı oluşturmak için yönetici kimlik bilgileriniz olmalıdır.

Bu gereksinim, olay kaynağının benzersiz olup olmadığını belirlemek için Güvenlik günlükleri de dahil olmak üzere tüm olay günlüklerinin aranması gerektiğidir. Windows Vista'dan başlayarak, kullanıcıların Güvenlik günlüğüne erişim izni yoktur; bu nedenle, bir SecurityException oluşturulur.

Uygulamalar ve hizmetler Uygulama günlüğüne veya özel bir günlüğe yazmalıdır. Cihaz sürücüleri Sistem günlüğüne yazmalıdır. Özelliği açıkça ayarlamazsanız Log , olay günlüğü varsayılan olarak Uygulama günlüğü olarak ayarlanır.

WriteEvent Olay günlüğüne olay yazmak için ve WriteEntry yöntemlerini kullanın. Olayları yazmak için bir olay kaynağı belirtmeniz gerekir; kaynakla ilk girdiyi yazmadan önce olay kaynağını oluşturmanız ve yapılandırmanız gerekir.

Uygulamanızın yüklenmesi sırasında yeni olay kaynağını İçerik Oluşturucu. Bu, işletim sisteminin kayıtlı olay kaynakları listesini ve bunların yapılandırmasını yenilemesine izin verir. İşletim sistemi olay kaynakları listesini yenilemediyse ve yeni kaynakla bir olay yazmaya çalışırsanız, yazma işlemi başarısız olur. Bir nesnesi veya CreateEventSource yöntemi kullanarak yeni bir EventLogInstaller kaynak yapılandırabilirsiniz. Yeni bir olay kaynağı oluşturmak için bilgisayarda yönetici kimlik bilgileriniz olmalıdır.

Her kaynak aynı anda yalnızca bir olay günlüğüne yazabilir; ancak uygulamanız birden çok olay günlüğüne yazmak için birden çok kaynak kullanabilir. Örneğin, uygulamanız farklı olay günlükleri veya farklı kaynak dosyaları için yapılandırılmış birden çok kaynak gerektirebilir. Var olan bir kaynağın yapılandırma ayrıntılarını değiştirmek için kaynağı silmeniz ve ardından yeni yapılandırmayla oluşturmanız gerekir. Diğer uygulamalar veya bileşenler mevcut kaynağı kullanıyorsa, mevcut kaynağı silmek yerine güncelleştirilmiş yapılandırmayla yeni bir kaynak oluşturun.

Olay kaynağınızı, olay kategoriniz ve ileti dizeleriniz için yerelleştirilmiş kaynaklara kaydedebilirsiniz. Uygulamanız, gerçek dize değerlerini belirtmek yerine kaynak tanımlayıcılarını kullanarak olay günlüğü girdileri yazabilir. EventLogInstaller Kaynağınızı kaynak dosyalarıyla yapılandırma hakkında daha fazla bilgi için ve EventSourceCreationData sınıflarına bakın.

Uygulamanız dize değerlerini doğrudan olay günlüğüne yazıyorsa, kaynak için kaynak dosyası özelliklerini ayarlamanız gerekmez. Kaynak, yerelleştirilmiş girdiler yazmak veya doğrudan dizeler yazmak için yapılandırılmalıdır. Uygulamanız hem kaynak tanımlayıcılarını hem de dize değerlerini kullanarak girdi yazıyorsa, iki ayrı kaynağı kaydetmeniz gerekir. Örneğin, kaynak dosyalarıyla bir kaynak yapılandırın ve ardından olay günlüğüne kaynak tanımlayıcılarını kullanarak girdi yazmak için yönteminde bu kaynağı WriteEvent kullanın. Ardından kaynak dosyaları olmadan farklı bir kaynak oluşturun ve bu kaynağı kullanarak dizeleri doğrudan olay günlüğüne yazmak için yönteminde WriteEntry kullanın.

Olayları yazarken, en azından bir ileti dizesi veya ileti dizesi için kaynak tanımlayıcısı belirtmeniz gerekir. Diğer olay özellikleri isteğe bağlıdır. İsteğe bağlı olay ayarlarına örnek olarak şunlar verilebilir:

• Olay Görüntüleyicisi giriş için görüntülediği simgeyi belirtecek şekilde ayarlayabilirsinizEventLogEntryType.

• Uygulamanız olayları filtrelemek için kategoriler kullanıyorsa olay için bir kategori tanımlayıcısı belirtebilirsiniz.

• Belirli bir olayla ek bilgileri ilişkilendirmek istiyorsanız, olay girdinize ikili veri ekleyebilirsiniz.

örneğinin ilk özellik değerlerinin EventLoglistesi için oluşturucuya EventLog bakın.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase