EventLogInstaller Sınıf

Tanım

Ad Alanı:

System.Diagnostics

Bütünleştirilmiş Kod:

System.Configuration.Install.dll

Çalışırken uygulamanızın okuduğu veya yazdığı bir olay günlüğünü yüklemenize ve yapılandırmanıza olanak tanır.

public ref class EventLogInstaller : System::Configuration::Install::ComponentInstaller

public class EventLogInstaller : System.Configuration.Install.ComponentInstaller

type EventLogInstaller = class
    inherit ComponentInstaller

Public Class EventLogInstaller
Inherits ComponentInstaller

Devralma

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Örnekler

Aşağıdaki kod örneği, yeni bir olay kaynağı için yükleme özelliklerini ayarlar. Kod örneği, kaynak adı ve olay günlüğü adını ayarlar ve öğesini koleksiyona Installers eklerEventLogInstaller.

using System;
using System.Configuration.Install;
using System.Diagnostics;
using System.ComponentModel;

[RunInstaller(true)]
public class MyEventLogInstaller: Installer
{
    private EventLogInstaller myEventLogInstaller;

    public MyEventLogInstaller()
    {
        // Create an instance of an EventLogInstaller.
        myEventLogInstaller = new EventLogInstaller();

        // Set the source name of the event log.
        myEventLogInstaller.Source = "NewLogSource";

        // Set the event log that the source writes entries to.
        myEventLogInstaller.Log = "MyNewLog";

        // Add myEventLogInstaller to the Installer collection.
        Installers.Add(myEventLogInstaller);
    }

    public static void Main()
    {
        MyEventLogInstaller myInstaller = new MyEventLogInstaller();
    }
}

   Imports System.Configuration.Install
Imports System.Diagnostics
Imports System.ComponentModel

<RunInstaller(True)>  _
Public Class MyEventLogInstaller
   Inherits Installer
   Private myEventLogInstaller As EventLogInstaller
   
   Public Sub New()

      ' Create an instance of an EventLogInstaller.
      myEventLogInstaller = New EventLogInstaller()

      ' Set the source name of the event log.
      myEventLogInstaller.Source = "NewLogSource"

      ' Set the event log that the source writes entries to.
      myEventLogInstaller.Log = "MyNewLog"

      ' Add myEventLogInstaller to the Installer collection.
      Installers.Add(myEventLogInstaller)
   End Sub

 Public Shared Sub Main()
 End Sub
 Dim myInstaller As New EventLogInstaller()
End Class

Açıklamalar

EventLogInstaller bir olay günlüğü yüklenirken Installutil.exe (Yükleyici Aracı) tarafından kullanılır. EventLogInstaller sınıfı olay günlüklerini yalnızca yerel bilgisayara yükleyebilir.

Uygulamanız bir olay günlüğüne yazarken sınıfını EventLogInstaller kullanın; uygulamanızın bir olay günlüğünden okuması için bir olay günlüğü yükleyicisi kullanmanız gerekmez. 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.

Uyarı

Güvenlik günlüğü salt okunurdur.

Yükleyici, özelliğinde Source belirttiğiniz olay kaynağını oluşturur ve özelliğinde Log belirtilen olay günlüğüne kaydeder. Bu davranış, bileşen üzerinde çağırmaya CreateEventSourceEventLog benzer.

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 yapılandırmalarını yenilemesi için zaman tanır. İşletim sistemi olay kaynakları listesini yenilemediyse ve yeni kaynakla bir olay yazmaya çalışırsanız, yazma işlemi başarısız olur. bir kullanarak veya yöntemini kullanarak CreateEventSource yeni bir EventLogInstallerkaynak yapılandırabilirsiniz. Yeni bir olay kaynağı oluşturmak için bilgisayarda yönetici haklarına sahip olmanız gerekir.

Mevcut bir olay günlüğü veya yeni olay günlüğü için bir olay kaynağı oluşturabilirsiniz. Yeni bir olay günlüğü için yeni bir kaynak oluşturduğunuzda, sistem bu günlük için kaynağı kaydeder, ancak ilk girdi ona yazılana kadar günlük oluşturulmaz.

Olay günlüğü yüklemek için, öğesinden Installerdevralan bir proje yükleyici sınıfı oluşturun ve sınıfı için öğesini olarak trueayarlayınRunInstallerAttribute. Projenizde, uygulamanızın yazacağı her olay günlüğü için bir EventLogInstaller oluşturun ve örneği proje yükleyici sınıfınıza ekleyin.

Installutil.exe (Yükleyici Aracı) çağrıldığında, öğesine RunInstallerAttributebakar. ise true, araç koleksiyondaki Installers proje yükleyicinizle ilişkili tüm öğeleri yükler. ise RunInstallerAttributefalse, araç proje yükleyicisini yoksayar.

Örneği proje yükleyicinizin koleksiyonuna eklemeden Installers önce veya ekledikten sonra, ancak yükleyici aracı çalışmadan önce bir EventLogInstaller öğesinin diğer özelliklerini değiştirirsiniz. Uygulamanız olay günlüğüne yazacaksa özelliğini ayarlamanız Source gerekir.

Yeni veya var olan bir olay günlüğüne yeni bir kaynak kaydetmek için kullanın EventLogInstaller ; mevcut bir kaynağı değiştirmek için kullanmayın EventLogInstaller . sınıfı, EventLogInstaller mevcut bir kaynağın yapılandırma özelliklerini belirtilen yükleme özellikleriyle eşleşecek şekilde değiştirmez. Install özelliği bilgisayardaki farklı bir olay günlüğü için kayıtlı bir kaynak adıyla eşleşiyorsa Source yöntemi bir özel durum oluşturur. Install Özellik özelliğinde belirtilen Log aynı olay günlüğü için zaten kaydedilmiş bir kaynak adıyla eşleşiyorsa Source yöntemi kaynağı kaydetmez.

Olay kategoriniz ve ileti dizeleriniz için olay kaynağını yerelleştirilmiş kaynak dosyalarına kaydedebilirsiniz. Uygulamanız gerçek dizeyi belirtmek yerine kaynak tanımlayıcılarını kullanarak olay günlüğü girdileri yazabilir. Olay Görüntüleyicisi, geçerli dil ayarlarına göre yerelleştirilmiş kaynak dosyasındaki ilgili dizeyi bulmak ve görüntülemek için kaynak tanımlayıcısını kullanır. Olay kategorileri, iletileri ve parametre ekleme dizeleri için ayrı bir dosya kaydedebilir veya aynı kaynak dosyasını üç dize türü için de kaydedebilirsiniz. CategoryCountKaynağı olay günlüğüne yerelleştirilmiş girdiler yazacak şekilde yapılandırmak için , CategoryResourceFile, MessageResourceFileve ParameterResourceFile özelliklerini kullanın. Uygulamanız dize değerlerini doğrudan olay günlüğüne yazıyorsa, bu özellikleri 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. Kaynak dosyaları olmadan farklı bir kaynak oluşturun ve ardından bu kaynağı WriteEntry kullanarak doğrudan olay günlüğüne dize yazmak için yönteminde bu kaynağı kullanın.

Genellikle, kodunuzun EventLogInstaller içinden sınıfının yöntemlerini çağırmazsınız; bunlar genellikle yalnızca Installutil.exetarafından çağrılır. Araç, yükleme işlemi sırasında yöntemini otomatik olarak çağırır Install . Gerekirse, özel durumu oluşturan nesne için yöntemini çağırarak Rollback hataları geri alır.

Oluşturucular

Name	Description
EventLogInstaller()	EventLogInstaller sınıfının yeni bir örneğini başlatır.

Özellikler

Name	Description
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
CategoryCount	Kategori kaynak dosyasındaki kategori sayısını alır veya ayarlar.
CategoryResourceFile	Kaynak için kategori dizelerini içeren kaynak dosyasının yolunu alır veya ayarlar.
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
Context	Geçerli yüklemeyle ilgili bilgileri alır veya ayarlar. (Devralındığı yer: Installer)
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
HelpText	Yükleyici koleksiyonundaki tüm yükleyiciler için yardım metnini alır. (Devralındığı yer: Installer)
Installers	Bu yükleyicinin içerdiği yükleyici koleksiyonunu alır. (Devralındığı yer: Installer)
Log	Kaynağın ayarlanacağı günlüğün adını alır veya ayarlar.
MessageResourceFile	Kaynak için ileti biçimlendirme dizelerini içeren kaynak dosyasının yolunu alır veya ayarlar.
ParameterResourceFile	Kaynak için ileti parametresi dizelerini içeren kaynak dosyasının yolunu alır veya ayarlar.
Parent	Bu yükleyicinin ait olduğu koleksiyonu içeren yükleyiciyi alır veya ayarlar. (Devralındığı yer: Installer)
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)
Source	Günlüğe kaydedilecek kaynak adını alır veya ayarlar.
UninstallAction	Installutil.exe (Yükleyici Aracı) olay günlüğünü kaldırması mı yoksa kaldırma sırasında yüklü durumda mı bırakması gerektiğini belirten bir değer alır veya ayarlar.

Yöntemler

Name	Description
Commit(IDictionary)	Türetilmiş bir sınıfta geçersiz kılındığında yükleme işlemini tamamlar. (Devralındığı yer: Installer)
CopyFromComponent(IComponent)	Bir olay günlüğü için yükleme zamanında gerekli olan bileşenin EventLog özellik değerlerini kopyalar.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	tarafından Componentkullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	tarafından Component kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: Component)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya Componenttarafından Container sağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
Install(IDictionary)	Yüklemeyi gerçekleştirir ve olay günlüğü bilgilerini kayıt defterine yazar.
IsEquivalentInstaller(ComponentInstaller)	Bir yükleyicinin ve belirtilen başka bir yükleyicinin aynı kaynağa başvurup başvurmadığını belirler.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
OnAfterInstall(IDictionary)	Olayı tetikler AfterInstall . (Devralındığı yer: Installer)
OnAfterRollback(IDictionary)	Olayı tetikler AfterRollback . (Devralındığı yer: Installer)
OnAfterUninstall(IDictionary)	Olayı tetikler AfterUninstall . (Devralındığı yer: Installer)
OnBeforeInstall(IDictionary)	Olayı tetikler BeforeInstall . (Devralındığı yer: Installer)
OnBeforeRollback(IDictionary)	Olayı tetikler BeforeRollback . (Devralındığı yer: Installer)
OnBeforeUninstall(IDictionary)	Olayı tetikler BeforeUninstall . (Devralındığı yer: Installer)
OnCommitted(IDictionary)	Olayı tetikler Committed . (Devralındığı yer: Installer)
OnCommitting(IDictionary)	Olayı tetikler Committing . (Devralındığı yer: Installer)
Rollback(IDictionary)	Yükleme yordamının kayıt defterine yazdığı olay günlüğü bilgilerini geri alarak bilgisayarı yüklemeden önceki durumuna geri yükler.
ToString()	Varsa, adını Stringiçeren bir Component döndürür. Bu yöntem geçersiz kılınmamalıdır. (Devralındığı yer: Component)
Uninstall(IDictionary)	Kayıt defterinden olay günlüğü bilgilerini kaldırarak yüklemeyi kaldırır.

Ekinlikler

Name	Description
AfterInstall	özelliğindeki Install(IDictionary) tüm yükleyicilerin Installers yöntemleri çalıştırıldıktan sonra gerçekleşir. (Devralındığı yer: Installer)
AfterRollback	özelliğindeki tüm yükleyicilerin yüklemeleri Installers geri alındıktan sonra gerçekleşir. (Devralındığı yer: Installer)
AfterUninstall	özelliğindeki Installers tüm yükleyiciler kaldırma işlemlerini gerçekleştirdikten sonra gerçekleşir. (Devralındığı yer: Installer)
BeforeInstall	Yükleyici koleksiyonundaki Install(IDictionary) her yükleyicinin yöntemi çalışmadan önce gerçekleşir. (Devralındığı yer: Installer)
BeforeRollback	özelliğindeki Installers yükleyiciler geri almadan önce gerçekleşir. (Devralındığı yer: Installer)
BeforeUninstall	özelliğindeki Installers yükleyiciler kaldırma işlemlerini gerçekleştirmeden önce gerçekleşir. (Devralındığı yer: Installer)
Committed	özelliğindeki tüm yükleyiciler Installers yüklemelerini işledikten sonra gerçekleşir. (Devralındığı yer: Installer)
Committing	özelliğindeki Installers yükleyiciler yüklemelerini işlemeden önce gerçekleşir. (Devralındığı yer: Installer)
Disposed	Bileşen yöntemine Dispose() yapılan bir çağrıyla atıldığında gerçekleşir. (Devralındığı yer: Component)

Ayrıca bkz.

• EventLog
• CreateEventSource
• Installutil.exe (Yükleyici Aracı)