Installer.Install(IDictionary) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Ketika ditimpa di kelas turunan, lakukan penginstalan.
public:
virtual void Install(System::Collections::IDictionary ^ stateSaver);
public virtual void Install (System.Collections.IDictionary stateSaver);
abstract member Install : System.Collections.IDictionary -> unit
override this.Install : System.Collections.IDictionary -> unit
Public Overridable Sub Install (stateSaver As IDictionary)
Parameter
- stateSaver
- IDictionary
Digunakan IDictionary untuk menyimpan informasi yang diperlukan untuk melakukan operasi penerapan, pembatalan, atau penghapusan instalasi.
Pengecualian
Parameternya stateSaver
adalah null
.
Pengecualian terjadi dalam penanganan BeforeInstall aktivitas salah satu penginstal dalam koleksi.
-atau-
Pengecualian terjadi dalam penanganan AfterInstall aktivitas salah satu penginstal dalam koleksi.
Contoh
Contoh berikut menunjukkan Install metode Installer kelas . Kelas berasal dari Installer kelas dasar dan Install metode ditimpa.
// Override the 'Install' method of the Installer class.
public:
virtual void Install( IDictionary^ mySavedState ) override
{
Installer::Install( mySavedState );
// Code maybe written for installation of an application.
Console::WriteLine( "The Install method of 'MyInstallerSample' has been called" );
}
// Override the 'Install' method of the Installer class.
public override void Install( IDictionary mySavedState )
{
base.Install( mySavedState );
// Code maybe written for installation of an application.
Console.WriteLine( "The Install method of 'MyInstallerSample' has been called" );
}
' Override the 'Install' method of the Installer class.
Public Overrides Sub Install(mySavedState As IDictionary)
MyBase.Install(mySavedState)
' Code maybe written for installation of an application.
Console.WriteLine("The Install method of 'MyInstallerSample' has been called")
End Sub
Catatan Bagi Inheritor
Jika Anda mengambil Install(IDictionary) alih metode di kelas turunan, pastikan untuk memanggil metode kelas Install(IDictionary) dasar terlebih dahulu dalam metode turunan Anda. Metode ini Install(IDictionary) memanggil metode dari setiap alat penginstal Install(IDictionary) yang terkandung dalam Installers properti instans ini. Setelah alat penginstal yang terkandung berjalan, metode ini memperbarui IDictionary objek (ditentukan melalui
stateSaver
parameter) untuk mencerminkan status penginstalan. IDictionary harus kosong ketika diteruskan ke Install(IDictionary) metode . Jika semua Install(IDictionary) metode berhasil, Commit(IDictionary) metode dipanggil. Jika tidak, Rollback(IDictionary) metode dipanggil.Jika Anda perlu menambahkan instans alat penginstal ke Installers koleksi dalam Install(IDictionary) metode , pastikan untuk melakukan penambahan yang sama ke koleksi dalam Uninstall(IDictionary) metode . Namun, Anda dapat menghindari mempertahankan koleksi di kedua metode jika Anda menambahkan instans alat penginstal ke Installers koleksi di konstruktor kelas untuk alat penginstal kustom Anda.