EventLogInstaller Sınıf

Tanım

Çalıştırılırken uygulamanızın okuması veya yazması için bir olay günlüğü yükleyip 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

Örnekler

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

#using <System.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Configuration::Install;
using namespace System::Diagnostics;
using namespace System::ComponentModel;

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

public:
   MyEventLogInstaller()
   {
      // Create an instance of an EventLogInstaller.
      myEventLogInstaller = gcnew 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 );
   }
};
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.

Not

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üğü için kaydeder. Bu davranış, bileşen üzerinde çağrıya 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şturmanız ve 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ı 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. 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 bir olay günlüğü için 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.

Bir 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 bakarRunInstallerAttribute. 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 Installers eklemeden ö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 EventLogInstaller veya var olan bir olay günlüğüne yeni bir kaynak kaydetmek için kullanın; var olan 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 özellik 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, iletiler 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ı 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. Kaynak dosyaları olmadan farklı bir kaynak oluşturun ve ardından bu kaynağı WriteEntry kullanarak dizeleri doğrudan olay günlüğüne yazmak için yönteminde kullanın.

Genellikle, sınıfın yöntemlerini kodunuzun EventLogInstaller içinden çağırmazsınız; bunlar genellikle yalnızca Installutil.exe tarafı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

EventLogInstaller()

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

Özellikler

CanRaiseEvents

Bileşenin bir 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ı) kaldırma sırasında olay günlüğünü kaldırması veya yüklü durumda bırakması gerektiğini belirten bir değer alır veya ayarlar.

Yöntemler

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()

Component tarafından kullanılan tüm kaynakları serbest bırakır.

(Devralındığı yer: Component)
Dispose(Boolean)

Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak 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()
Geçersiz.

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 tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür.

(Devralındığı yer: Component)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
InitializeLifetimeService()
Geçersiz.

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 Objectöğesinin sığ 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ı Componentiçeren bir String 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

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 yüklendikten 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 alınmadan ö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 Installers tüm yükleyiciler 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ı tarafından atıldığında gerçekleşir.

(Devralındığı yer: Component)

Şunlara uygulanır

Ayrıca bkz.