EventLog Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Diagnostics.EventLog.dll

Kaynak:

EventLog.cs

Windows olay günlükleriyle etkileşim sağlar.

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 girdi yazar.

Uyarı

Bu uygulamayı yönetici olarak çalıştırmanız gerekir.

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.

Önemli

Bu tür IDisposable arabirimini uygular. Kullanımını bitirdiğinizde, doğrudan ya da dolaylı yoldan atmalısınız. Türü doğrudan atabilmek için, bir Disposetry/ bloğunda catch yöntemini çağırın. Bunu dolaylı olarak atmak için using (C#'de) veya Using (Visual Basic'te) gibi bir dil yapısı kullanın. Daha fazla bilgi için arabirim konusunun "IDisposable Uygulayan Bir Nesne Kullanma" bölümüne IDisposable bakın.

Sınıfı, tek tek olay günlüklerine ve bunların girişlerine erişim sağlamanın EventLog yanı sıra tüm 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çerip içermediğ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ını kullanırken EventLog güvenlikle ilgili dikkat edilmesi gerekenler vardır. EventLog belirli eylemler için izinler EventLogPermission 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, bir giriş 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 üyesiyseniz, 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ündesiniz. 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ıklayarak) ve yönetici olarak çalıştırmak istediğinizi belirterek bunu yapabilirsiniz.

Sunucunun Olay Görüntüleyicisi aracılığıyla görüntüleyebileceğiniz özel olay günlükleri oluşturmak için kullanabilirsiniz EventLog . Olay Görüntüleyicisi'nde RegisterDisplayName 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, olay günlüğü için günlük adını (Log özellik) ve sunucu bilgisayar adını (MachineName özelliğini) belirtin. Sunucu bilgisayar adını belirtmezseniz, yerel bilgisayar olan "." varsayılır. Yalnızca günlüklere yazmak için bir kaynak gerektiğinden, olay kaynağının (Source özelliğinin) belirtilmesi gerekmez. Entries özelliği, olay günlüğünün girdi listesiyle otomatik olarak doldurulur.

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 aynı anda 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ırsa bir özel durum oluşturulur. Ancak, tek bir olay günlüğü birden çok kaynakla ilişkilendirilebilir.

Örnekle EventLog ilişkili 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, güvenlik günlükleri de dahil olmak üzere tüm olay günlüklerinin, olay kaynağının benzersiz olup olmadığını belirlemek için aranması gerektiğidir. Windows Vista'dan başlayarak kullanıcıların Güvenlik günlüğüne erişme izni yoktur; bu nedenle, bir SecurityException oluşturulur.

Önemli

Olay kaynağı oluşturmak veya silmek için, adlandırılmış bir mutex kullanarak temel alınan kodun eşitlenmesi gerekir. Yüksek ayrıcalıklı bir uygulama adlandırılmış mutex'i kilitlerse, olay kaynağı oluşturmaya veya silmeye çalışmak, kilit serbest bırakılana kadar uygulamanın yanıt vermeyi durdurmasına neden olur. Bu sorunun önlenmesine yardımcı olmak için, güvenilmeyen koda hiçbir zaman izin verme UnmanagedCode . Buna ek olarak, UnmanagedCode izin diğer izinlerin atlanmasına izin verir ve yalnızca yüksek oranda güvenilen koda verilmelidir.

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üğü olur.

Uyarı

Bir uygulamayı herhangi bir kayıtlı kaynak olarak yazmaktan koruyacak hiçbir şey yoktur. Bir uygulamaya izin verilirse Write , bilgisayarda kayıtlı geçerli herhangi bir kaynak için olaylar yazabilir.

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şturup yapılandırmanız gerekir.

Uygulamanızın yüklenmesi sırasında yeni olay kaynağını oluşturun. 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 nesne 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 kategoriniz ve ileti dizeleriniz için yerelleştirilmiş kaynaklara olay kaynağını 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ı kaynak 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 doğrudan olay günlüğüne dize yazmak için yönteminde WriteEntry kullanın.

Olayları yazarken, en azından ileti dizesi için bir ileti dizesi veya 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:

• girdisi EventLogEntryType için Olay Görüntüleyicisi'nin görüntülediği simgeyi belirtmek için öğesini ayarlayabilirsiniz.

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

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

Önemli

Olay günlüğü disk alanı, işlemci süresi ve diğer sistem kaynaklarını kullanır. Yalnızca temel bilgileri günlüğe kaydetmek önemlidir. Performansı olumsuz etkilememeleri için olay günlüğü çağrılarını ana kod yolu yerine bir hata yoluna yerleştirmenizi öneririz.

Bir EventLog örneğinin ilk özellik değerlerinin listesini görmek için EventLog oluşturucusuna bakın.

Oluşturucular

Name	Description
EventLog()	EventLog sınıfının yeni bir örneğini başlatır. Örneği herhangi bir günlükle ilişkilendirmez.
EventLog(String, String, String)	EventLog sınıfının yeni bir örneğini başlatır. Örneği belirtilen bilgisayarda bir günlükle ilişkilendirir ve belirtilen kaynağı oluşturur veya öğesine EventLogatar.
EventLog(String, String)	EventLog sınıfının yeni bir örneğini başlatır. Örneği belirtilen bilgisayardaki bir günlükle ilişkilendirir.
EventLog(String)	EventLog sınıfının yeni bir örneğini başlatır. Örneği yerel bilgisayardaki bir günlükle ilişkilendirir.

Özellikler

Name	Description
EnableRaisingEvents	Olay bildirimlerini alıp almadığını EventLogEntryWritten belirten bir değer alır veya ayarlar.
Entries	Olay günlüğünün içeriğini alır.
Log	Okunacak veya yazacak günlüğün adını alır veya ayarlar.
LogDisplayName	Olay günlüğünün kolay adını alır.
MachineName	Olayların okunduğu veya yazıldığı bilgisayarın adını alır veya ayarlar.
MaximumKilobytes	En büyük olay günlüğü boyutunu kilobayt cinsinden alır veya ayarlar.
MinimumRetentionDays	Bu özellik kullanım dışıdır.
OverflowAction	Olay günlüğü en büyük günlük dosyası boyutuna ulaştığında yeni girdileri depolamak için yapılandırılmış davranışı alır.
Source	Olay günlüğüne yazarken kaydedilecek ve kullanılacak kaynak adını alır veya ayarlar.
SynchronizingObject	Giriş yazılı bir EventLog olayın sonucu olarak verilen olay işleyici çağrılarını sıralamak için kullanılan nesneyi alır veya ayarlar.

Yöntemler

Name	Description
BeginInit()	Formda kullanılan veya başka bir bileşen tarafından kullanılan bir EventLog öğesinin başlatılmasını başlatır. Başlatma çalışma zamanında gerçekleşir.
Clear()	Olay günlüğündeki tüm girişleri kaldırır.
Close()	Olay günlüğünü kapatır ve okuma ve yazma tanıtıcılarını serbest bırakır.
CreateEventSource(EventSourceCreationData)	Olay kaynağı ve ilgili olay günlüğü için belirtilen yapılandırma özelliklerini kullanarak yerelleştirilmiş olay iletileri yazmak için geçerli bir olay kaynağı oluşturur.
CreateEventSource(String, String, String)	Geçersiz. Belirtilen kaynak adını, belirtilen bilgisayardaki bir günlüğe girdi yazmak için geçerli bir olay kaynağı olarak oluşturur. Bu yöntem, belirtilen bilgisayarda yeni bir özel günlük oluşturmak için de kullanılabilir.
CreateEventSource(String, String)	Belirtilen kaynak adını, yerel bilgisayardaki bir günlüğe girdi yazmak için geçerli bir olay kaynağı olarak oluşturur. Bu yöntem, yerel bilgisayarda yeni bir özel günlük de oluşturabilir.
Delete(String, String)	Belirtilen bilgisayardan bir olay günlüğünü kaldırır.
Delete(String)	Yerel bilgisayardan bir olay günlüğünü kaldırır.
DeleteEventSource(String, String)	Uygulamanın olay kaynağı kaydını belirtilen bilgisayardan kaldırır.
DeleteEventSource(String)	Olay kaynağı kaydını yerel bilgisayarın olay günlüğünden kaldırır.
Dispose(Boolean)	tarafından EventLogkullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır.
EndInit()	Formda veya başka bir EventLog bileşen tarafından kullanılan bir öğesinin başlatılmasını sonlandırır. Başlatma çalışma zamanında gerçekleşir.
Exists(String, String)	Günlüğün belirtilen bilgisayarda var olup olmadığını belirler.
Exists(String)	Günlüğün yerel bilgisayarda var olup olmadığını belirler.
GetEventLogs()	Yerel bilgisayardaki tüm olay günlüklerini arar ve listeyi içeren bir nesne dizisi EventLog oluşturur.
GetEventLogs(String)	Verilen bilgisayardaki tüm olay günlüklerini arar ve listeyi içeren bir nesne dizisi EventLog oluşturur.
LogNameFromSourceName(String, String)	Belirtilen kaynağın kaydedildiği günlüğün adını alır.
ModifyOverflowPolicy(OverflowAction, Int32)	Olay günlüğü dosya boyutu üst sınırına ulaştığında yeni girdiler yazmak için yapılandırılmış davranışı değiştirir.
RegisterDisplayName(String, Int64)	Olay Görüntüleyicisi sunucusunda görüntülenen olay günlüğünün yerelleştirilmiş adını belirtir.
SourceExists(String, String)	Bir olay kaynağının belirtilen bilgisayarda kayıtlı olup olmadığını belirler.
SourceExists(String)	Bir olay kaynağının yerel bilgisayarda kayıtlı olup olmadığını belirler.
WriteEntry(String, EventLogEntryType, Int32, Int16, Byte[])	Verilen ileti metnini, uygulama tanımlı olay tanımlayıcısını ve uygulama tanımlı kategoriyi içeren bir girdiyi olay günlüğüne yazar ve iletiye ikili veri ekler.
WriteEntry(String, EventLogEntryType, Int32, Int16)	Verilen ileti metnini, uygulama tanımlı olay tanımlayıcısını ve uygulama tanımlı kategoriyi içeren bir girdiyi olay günlüğüne yazar.
WriteEntry(String, EventLogEntryType, Int32)	Olay günlüğüne verilen ileti metnini ve uygulama tanımlı olay tanımlayıcısını içeren bir girdi yazar.
WriteEntry(String, EventLogEntryType)	Olay günlüğüne verilen ileti metniyle bir hata, uyarı, bilgi, başarı denetimi veya hata denetimi girişi yazar.
WriteEntry(String, String, EventLogEntryType, Int32, Int16, Byte[])	Belirtilen ileti metnini, uygulama tanımlı olay tanımlayıcısını ve uygulama tanımlı kategoriyi içeren bir girdiyi olay günlüğüne yazar (belirtilen kayıtlı olay kaynağını kullanarak) ve iletiye ikili veri ekler.
WriteEntry(String, String, EventLogEntryType, Int32, Int16)	Belirtilen kayıtlı olay kaynağını kullanarak olay günlüğüne verilen ileti metnini, uygulama tanımlı olay tanımlayıcısını ve uygulama tanımlı kategoriyi içeren bir girdi yazar. , category Olay Görüntüleyicisi tarafından günlükteki olayları filtrelemek için kullanılabilir.
WriteEntry(String, String, EventLogEntryType, Int32)	Belirtilen kayıtlı olay kaynağını kullanarak, belirtilen ileti metnini ve uygulama tanımlı olay tanımlayıcısını içeren bir girdiyi olay günlüğüne yazar.
WriteEntry(String, String, EventLogEntryType)	Belirtilen kayıtlı olay kaynağını kullanarak olay günlüğüne verilen ileti metniyle bir hata, uyarı, bilgi, başarı denetimi veya hata denetimi girişi yazar.
WriteEntry(String, String)	Belirtilen kayıtlı olay kaynağını kullanarak olay günlüğüne verilen ileti metnini içeren bir bilgi türü girdisi yazar.
WriteEntry(String)	Olay günlüğüne verilen ileti metnini içeren bir bilgi türü girdisi yazar.
WriteEvent(EventInstance, Byte[], Object[])	Verilen olay verileri, ileti değiştirme dizeleri ve ilişkili ikili verileri içeren bir olay günlüğü girdisi yazar.
WriteEvent(EventInstance, Object[])	Olay günlüğüne yerelleştirilmiş bir girdi yazar.
WriteEvent(String, EventInstance, Byte[], Object[])	Belirtilen olay verilerini, ileti değiştirme dizelerini ve ilişkili ikili verileri içeren ve belirtilen kayıtlı olay kaynağını kullanarak bir olay günlüğü girdisi yazar.
WriteEvent(String, EventInstance, Object[])	Belirtilen kayıtlı olay kaynağını kullanarak verilen olay verileri ve ileti değiştirme dizeleriyle bir olay günlüğü girdisi yazar.

Ekinlikler

Name	Description
EntryWritten	Yerel bilgisayardaki bir olay günlüğüne bir girdi yazıldığında gerçekleşir.

Ayrıca bkz.

• EventLogInstaller
• EventLogEntry
• EntryWrittenEventArgs
• ServiceBase