EventLogInstaller Sınıf

Tanım

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.

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

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

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