EventLogInstaller Sınıf

Başvuru

Tanım

Ad Alanı:: System.Diagnostics

Bütünleştirilmiş Kod:: System.Configuration.Install.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Ç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: Object

MarshalByRefObject

Component

Installer

ComponentInstaller
EventLogInstaller

Ö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 CreateEventSource EventLog 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ı İçerik Oluşturucu. 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ından karşılık gelen 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 İçerik Oluşturucu ve ardından bu kaynağı WriteEntry kullanarak doğrudan olay günlüğüne dize yazmak için yönteminde bu kaynağı 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 ISite Component. (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 Component Containersağ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