EventLogInstaller Kelas

Definisi

Ruang nama:

System.Diagnostics

Rakitan:

System.Configuration.Install.dll

Memungkinkan Anda menginstal dan mengonfigurasi log peristiwa yang dibaca atau ditulis aplikasi Anda saat berjalan.

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

Warisan

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

EventLogInstaller

Contoh

Contoh kode berikut mengatur properti penginstalan untuk sumber peristiwa baru. Contoh kode mengatur nama sumber dan nama log peristiwa, dan menambahkan ke EventLogInstallerInstallers koleksi.

#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

Keterangan

EventLogInstaller digunakan oleh Installutil.exe (Alat Penginstal) saat menginstal log peristiwa. Kelas EventLogInstaller hanya dapat menginstal log peristiwa di komputer lokal.

EventLogInstaller Gunakan kelas saat aplikasi Anda menulis ke log peristiwa; tidak perlu menggunakan alat penginstal log peristiwa agar aplikasi Anda membaca dari log peristiwa. Aplikasi dan layanan harus menulis ke log Aplikasi atau log kustom. Driver perangkat harus menulis ke log Sistem.

Catatan

Log Keamanan bersifat baca-saja.

Alat penginstal membuat sumber peristiwa yang Anda tentukan di Source properti dan mendaftarkannya untuk log peristiwa yang ditentukan dalam Log properti . Perilaku ini mirip dengan panggilan CreateEventSource pada EventLog komponen.

WriteEvent Gunakan metode dan WriteEntry untuk menulis peristiwa ke log peristiwa. Anda harus menentukan sumber kejadian untuk menulis peristiwa; Anda harus membuat dan mengonfigurasi sumber peristiwa sebelum menulis entri pertama dengan sumbernya.

Buat sumber peristiwa baru selama penginstalan aplikasi Anda. Ini memungkinkan waktu bagi sistem operasi untuk me-refresh daftar sumber peristiwa terdaftar dan konfigurasinya. Jika sistem operasi belum merefresh daftar sumber peristiwanya, dan Anda mencoba menulis peristiwa dengan sumber baru, operasi tulis akan gagal. Anda dapat mengonfigurasi sumber baru menggunakan EventLogInstaller, atau menggunakan CreateEventSource metode . Anda harus memiliki hak administratif pada komputer untuk membuat sumber kejadian baru.

Anda dapat membuat sumber peristiwa untuk log peristiwa yang sudah ada atau log peristiwa baru. Saat Anda membuat sumber baru untuk log peristiwa baru, sistem mendaftarkan sumber untuk log tersebut, tetapi log tidak dibuat sampai entri pertama ditulis ke dalamnya.

Untuk menginstal log peristiwa, buat kelas alat penginstal proyek yang mewarisi dari Installer, dan atur RunInstallerAttribute untuk kelas ke true. Dalam proyek Anda, buat EventLogInstaller untuk setiap log peristiwa yang akan ditulis aplikasi Anda dan tambahkan instans ke kelas penginstal proyek Anda.

Ketika Installutil.exe (Alat Penginstal) dipanggil RunInstallerAttribute, ia melihat . Jika ya true, alat ini menginstal semua item dalam Installers koleksi yang terkait dengan alat penginstal proyek Anda. Jika RunInstallerAttribute adalah false, alat mengabaikan alat penginstal proyek.

Anda mengubah properti lain baik EventLogInstaller sebelum atau sesudah menambahkan instans ke Installers koleksi alat penginstal proyek Anda, tetapi sebelum alat penginstal berjalan. Anda harus mengatur Source properti jika aplikasi Anda akan menulis ke log peristiwa.

Gunakan EventLogInstaller untuk mendaftarkan sumber baru untuk log peristiwa baru atau yang sudah ada; jangan gunakan EventLogInstaller untuk mengubah sumber yang ada. Kelas EventLogInstaller tidak mengubah properti konfigurasi sumber yang ada agar sesuai dengan properti penginstalan yang ditentukan. Metode ini Install memberikan pengecualian jika Source properti cocok dengan nama sumber yang terdaftar untuk log peristiwa yang berbeda di komputer. Metode Install tidak mendaftarkan sumber jika Source properti cocok dengan nama sumber yang sudah terdaftar untuk log peristiwa yang sama yang ditentukan dalam Log properti .

Anda dapat mendaftarkan sumber peristiwa dengan file sumber daya yang dilokalkan untuk kategori peristiwa dan string pesan Anda. Aplikasi Anda dapat menulis entri log peristiwa menggunakan pengidentifikasi sumber daya, daripada menentukan string aktual. Penampil Peristiwa menggunakan pengidentifikasi sumber daya untuk menemukan dan menampilkan string yang sesuai dari file sumber daya yang dilokalkan berdasarkan pengaturan bahasa saat ini. Anda dapat mendaftarkan file terpisah untuk kategori peristiwa, pesan, dan string penyisipan parameter, atau Anda dapat mendaftarkan file sumber daya yang sama untuk ketiga jenis string. CategoryCountGunakan properti , CategoryResourceFile, MessageResourceFile, dan ParameterResourceFile untuk mengonfigurasi sumber untuk menulis entri yang dilokalkan ke log peristiwa. Jika aplikasi Anda menulis nilai string langsung ke log peristiwa, Anda tidak perlu mengatur properti ini.

Sumber harus dikonfigurasi baik untuk menulis entri yang dilokalkan atau untuk menulis string langsung. Jika aplikasi Anda menulis entri menggunakan pengidentifikasi sumber daya dan nilai string, Anda harus mendaftarkan dua sumber terpisah. Misalnya, konfigurasikan satu sumber dengan file sumber daya, lalu gunakan sumber tersebut WriteEvent dalam metode untuk menulis entri menggunakan pengidentifikasi sumber daya ke log peristiwa. Buat sumber yang berbeda tanpa file sumber daya lalu gunakan sumber tersebut WriteEntry dalam metode untuk menulis string langsung ke log peristiwa menggunakan sumber tersebut.

Biasanya, Anda tidak memanggil metode EventLogInstaller kelas dari dalam kode Anda; metode umumnya hanya dipanggil oleh Installutil.exe. Alat ini secara otomatis memanggil Install metode selama proses penginstalan. Ini mendukung kegagalan, jika perlu, dengan memanggil Rollback metode untuk objek yang menghasilkan pengecualian.

Konstruktor

EventLogInstaller()

Menginisialisasi instans baru kelas EventLogInstaller.

Properti

CanRaiseEvents	Mendapatkan nilai yang menunjukkan apakah komponen dapat menaikkan peristiwa. (Diperoleh dari Component)
CategoryCount	Mendapatkan atau mengatur jumlah kategori dalam file sumber daya kategori.
CategoryResourceFile	Mendapatkan atau mengatur jalur file sumber daya yang berisi string kategori untuk sumbernya.
Container	IContainer Mendapatkan yang berisi Component. (Diperoleh dari Component)
Context	Mendapatkan atau mengatur informasi tentang penginstalan saat ini. (Diperoleh dari Installer)
DesignMode	Mendapatkan nilai yang menunjukkan apakah Component saat ini dalam mode desain. (Diperoleh dari Component)
Events	Mendapatkan daftar penanganan aktivitas yang dilampirkan ke ini Component. (Diperoleh dari Component)
HelpText	Mendapatkan teks bantuan untuk semua penginstal dalam koleksi alat penginstal. (Diperoleh dari Installer)
Installers	Mendapatkan kumpulan alat penginstal yang dikandung alat penginstal ini. (Diperoleh dari Installer)
Log	Mendapatkan atau mengatur nama log untuk mengatur sumbernya.
MessageResourceFile	Mendapatkan atau mengatur jalur file sumber daya yang berisi string pemformatan pesan untuk sumber.
ParameterResourceFile	Mendapatkan atau mengatur jalur file sumber daya yang berisi string parameter pesan untuk sumbernya.
Parent	Mendapatkan atau mengatur alat penginstal yang berisi koleksi tempat alat penginstal ini berada. (Diperoleh dari Installer)
Site	Mendapatkan atau mengatur ISite dari Component. (Diperoleh dari Component)
Source	Mendapatkan atau mengatur nama sumber untuk mendaftar dengan log.
UninstallAction	Mendapatkan atau menetapkan nilai yang menunjukkan apakah Installutil.exe (Alat Alat Penginstal) harus menghapus log peristiwa atau membiarkannya dalam status terinstal pada waktu penghapusan instalasi.

Metode

Commit(IDictionary)	Ketika ditimpa di kelas turunan, menyelesaikan transaksi penginstalan. (Diperoleh dari Installer)
CopyFromComponent(IComponent)	Menyalin nilai properti komponen EventLog yang diperlukan pada waktu penginstalan untuk log peristiwa.
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang Componentdigunakan oleh . (Diperoleh dari Component)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh Component dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Component)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetService(Type)	Mengembalikan objek yang mewakili layanan yang disediakan oleh Component atau oleh Container. (Diperoleh dari Component)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
Install(IDictionary)	Melakukan penginstalan dan menulis informasi log peristiwa ke registri.
IsEquivalentInstaller(ComponentInstaller)	Menentukan apakah alat penginstal dan alat penginstal lain yang ditentukan merujuk ke sumber yang sama.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
OnAfterInstall(IDictionary)	Memunculkan kejadian AfterInstall. (Diperoleh dari Installer)
OnAfterRollback(IDictionary)	Memunculkan kejadian AfterRollback. (Diperoleh dari Installer)
OnAfterUninstall(IDictionary)	Memunculkan kejadian AfterUninstall. (Diperoleh dari Installer)
OnBeforeInstall(IDictionary)	Memunculkan kejadian BeforeInstall. (Diperoleh dari Installer)
OnBeforeRollback(IDictionary)	Memunculkan kejadian BeforeRollback. (Diperoleh dari Installer)
OnBeforeUninstall(IDictionary)	Memunculkan kejadian BeforeUninstall. (Diperoleh dari Installer)
OnCommitted(IDictionary)	Memunculkan kejadian Committed. (Diperoleh dari Installer)
OnCommitting(IDictionary)	Memunculkan kejadian Committing. (Diperoleh dari Installer)
Rollback(IDictionary)	Memulihkan komputer ke status sebelum penginstalan dengan mengembalikan informasi log peristiwa yang ditulis prosedur penginstalan ke registri.
ToString()	Mengembalikan yang String berisi nama Component, jika ada. Metode ini tidak boleh ditimpa. (Diperoleh dari Component)
Uninstall(IDictionary)	Menghapus penginstalan dengan menghapus informasi log peristiwa dari registri.

Acara

AfterInstall	Terjadi setelah Install(IDictionary) metode semua penginstal di Installers properti telah berjalan. (Diperoleh dari Installer)
AfterRollback	Terjadi setelah penginstalan semua penginstal di Installers properti digulung balik. (Diperoleh dari Installer)
AfterUninstall	Terjadi setelah semua penginstal di Installers properti melakukan operasi penghapusan instalasi mereka. (Diperoleh dari Installer)
BeforeInstall	Terjadi sebelum Install(IDictionary) metode setiap alat penginstal dalam koleksi alat penginstal telah berjalan. (Diperoleh dari Installer)
BeforeRollback	Terjadi sebelum alat penginstal di Installers properti digulung balik. (Diperoleh dari Installer)
BeforeUninstall	Terjadi sebelum alat penginstal di Installers properti melakukan operasi penghapusan instalasinya. (Diperoleh dari Installer)
Committed	Terjadi setelah semua penginstal di Installers properti telah melakukan penginstalan mereka. (Diperoleh dari Installer)
Committing	Terjadi sebelum penginstal di Installers properti melakukan penginstalan mereka. (Diperoleh dari Installer)
Disposed	Terjadi ketika komponen dibuang oleh panggilan ke Dispose() metode . (Diperoleh dari Component)

Lihat juga

• EventLog
• CreateEventSource
• Installutil.exe (Alat Penginstal)