Procedura: eseguire l'override dei metodi predefiniti in un componente di installazione
Aggiornamento: novembre 2007
Per impostazione predefinita, per ogni componente di installazione sono disponibili i metodi indicati di seguito.
Install: tutte le funzioni di installazione che devono essere eseguite dal programma di installazione sono effettuate all'interno di questo metodo. La classe Installer1 o qualsiasi altra classe con il valore RunInstallerAttribute impostato su true chiama il metodo Install su ciascun componente di installazione contenuto, quindi chiama il metodo Commit, se le installazioni sono state eseguite correttamente, oppure il metodo Rollback, in caso di errori.
Commit: il metodo Commit viene chiamato se il metodo Install è stato eseguito correttamente su tutti i componenti di installazione contenuti nella classe del programma di installazione. A questo punto tutte le installazioni sono completate. In genere, non viene effettuata alcuna elaborazione nel metodo Commit, al fine di evitare che vengano generate eccezioni.
Rollback: il metodo Rollback viene utilizzato per annullare tutte le operazioni di installazione precedenti, qualora si verifichi un errore in un punto qualsiasi del processo di installazione. Se per uno qualsiasi dei componenti di installazione contenuto dalla classe del programma di installazione viene generato un errore, vengono annullate tutte le installazioni completate fino a quel momento.
Uninstall: il metodo Uninstall viene utilizzato per rimuovere le risorse del componente di installazione dal sistema. A differenza dell'installazione, la disinstallazione non è transazionale. Se un processo di disinstallazione non riesce, verranno comunque effettuati dei tentativi per disinstallare tutte le altre risorse.
Ciascuno dei metodi contiene un'elaborazione predefinita con cui verrà svolto tutto il lavoro richiesto senza modifiche. Se lo si desidera, tuttavia, è possibile eseguire l'override e modificare l'elaborazione in ogni fase. Per un componente di installazione ServiceBase, è ad esempio possibile modificare l'elaborazione predefinita eseguita nella routine Commit in modo tale che al termine del processo di installazione venga avviato il servizio. È anche possibile modificare la routine Uninstall in modo tale che ogni servizio venga arrestato prima di essere disinstallato.
Per eseguire l'override dei metodi predefiniti per un componente di installazione
Dopo aver aggiunto un componente di installazione alla soluzione, aprire la classe Installer.
Individuare il componente di installazione che si desidera modificare e accedervi mediante l'Editor di codice.
Eseguire l'override del metodo appropriato e aggiungere la funzionalità desiderata. Per ulteriori informazioni, vedere Override di proprietà e metodi.
Suggerimento: Accertarsi di mantenere l'elaborazione originale necessaria per eseguire l'installazione, il commit, il rollback o la disinstallazione delle risorse quando si esegue l'override dei metodi della classe Installer1. In generale è necessario aggiungere del codice alle funzioni esistenti anziché rimuovere la funzionalità esistente.
Vedere anche
Attività
Procedura: aggiungere componenti di installazione ai progetti
Procedura: configurare i componenti di installazione
Procedura dettagliata: installazione di un componente Event Log