Condividi tramite


MessageQueueInstaller.Install(IDictionary) Metodo

Definizione

Esegue l'installazione e scrive nel Registro di sistema le informazioni della coda di messaggi. Questo metodo è progettato per essere utilizzato dagli strumenti di installazione, che chiamano automaticamente i metodi corretti.

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)

Parametri

stateSaver
IDictionary

Oggetto IDictionary utilizzato per salvare le informazioni necessarie per eseguire un'operazione di commit, di rollback o di disinstallazione.

Commenti

Il Install metodo scrive le informazioni sulla coda dei messaggi nel Registro di sistema e associa l'istanza MessageQueue a una coda che si trova nel percorso specificato dalla Path proprietà . Se la coda non esiste già, Install crea una coda transazionale. Install imposta le proprietà della coda nuove o esistenti su quelle specificate in MessageQueueInstaller. Se la coda esiste già, le relative proprietà vengono reimpostate su quelle di MessageQueueInstaller. Se la coda esistente non è transazionale, viene eliminata e quindi ricreata come coda transazionale.

Attenzione

Se è necessario ricreare la coda, i messaggi nella coda andranno persi.

In genere, non si chiamano i metodi dell'oggetto MessageQueueInstaller dall'interno del codice, ma vengono in genere chiamati solo dall'utilità di installazione installutil.exe. L'utilità chiama automaticamente il Install metodo durante il processo di installazione per scrivere informazioni del Registro di sistema associate alla coda di messaggi in fase di installazione. L'installazione è transazionale, quindi se si verifica un errore di un componente del progetto di installazione durante l'installazione, viene eseguito il rollback di tutti i componenti installati in precedenza ai relativi stati di preinstallazione. Questa operazione viene eseguita chiamando il metodo di Rollback ogni componente.

Dopo aver completato l'installazione di tutti i componenti associati al progetto di installazione, l'utilità di installazione esegue il commit delle installazioni. Commit completa l'installazione di MessageQueue impostando la coda sullo stato iniziale appropriato. Se la coda specificata dalla Path proprietà esiste già e contiene messaggi, Commit cancella i messaggi. Commit, anziché Install, cancella i messaggi perché non è possibile eseguire il rollback dell'azione di eliminazione dei messaggi.

La routine di installazione di un'applicazione usa il programma di installazione del Installer.Context progetto per mantenere automaticamente le informazioni sui componenti già installati. Queste informazioni sullo stato, passate come InstallstateSaver parametro, vengono aggiornate continuamente quando l'utilità installa ogni MessageQueueInstaller istanza. In genere, non è necessario che il codice modifichi in modo esplicito queste informazioni sullo stato.

Si applica a

Vedi anche