Bagikan melalui

EventLogInstaller.Install(IDictionary) Metode

  • Referensi

Definisi

Ruang nama:
System.Diagnostics
Rakitan:
System.Configuration.Install.dll

Melakukan penginstalan dan menulis informasi log peristiwa ke registri.

public:
 override void Install(System::Collections::IDictionary ^ stateSaver);
public override void Install (System.Collections.IDictionary stateSaver);
override this.Install : System.Collections.IDictionary -> unit
Public Overrides Sub Install (stateSaver As IDictionary)

Parameter

stateSaver
IDictionary

Digunakan IDictionary untuk menyimpan informasi yang diperlukan untuk melakukan operasi putar kembali atau hapus instalan.

Pengecualian

ArgumentException

Nama yang ditentukan dalam Source properti sudah terdaftar untuk log peristiwa yang berbeda.

Keterangan

Metode menulis Install informasi log peristiwa ke registri, dan mengaitkan log peristiwa dengan log yang ditentukan oleh Log properti . Jika log belum ada (dan sumber ditentukan), Install buat log dan kaitkan sumber baru dengannya.

Biasanya, Anda tidak memanggil metode dari dalam kode Anda; metode umumnya hanya dipanggil oleh Installutil.exe (Alat Alat PenginstalEventLogInstaller). Alat ini secara otomatis memanggil metode selama proses penginstalan untuk menulis informasi registri Install yang terkait dengan log peristiwa yang diinstal. Penginstalan bersifat transaksional, jadi jika ada kegagalan komponen proyek penginstalan selama penginstalan, semua komponen yang diinstal sebelumnya digulung balik ke status pra-penginstalannya. Ini dicapai dengan memanggil metode setiap komponen Rollback .

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 melompati pendaftaran sumber jika Source properti cocok dengan nama sumber yang sudah terdaftar untuk log peristiwa yang sama yang ditentukan dalam Log properti .

Rutinitas penginstalan aplikasi menggunakan properti alat Installer.Context penginstal proyek untuk secara otomatis mempertahankan informasi tentang komponen yang telah diinstal. Informasi status ini, yang diteruskan sebagai InstallstateSaver parameter, terus diperbarui saat alat menginstal masing-masing EventLogInstaller. Biasanya, kode Anda tidak perlu diubah secara eksplisit.

Berlaku untuk

Lihat juga