MessageQueueInstaller Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Consente di installare e configurare una coda necessaria per l'esecuzione dell'applicazione. Questa classe viene chiamata dall'utilità di installazione, ad esempio InstallUtil.exe, durante l'installazione di .MessageQueue
public ref class MessageQueueInstaller : System::Configuration::Install::ComponentInstallerpublic class MessageQueueInstaller : System.Configuration.Install.ComponentInstallertype MessageQueueInstaller = class
inherit ComponentInstallerPublic Class MessageQueueInstaller
Inherits ComponentInstaller- Ereditarietà
Commenti
Viene MessageQueueInstaller utilizzato dall'utilità di installazione per scrivere i valori del Registro di sistema associati alla coda. Per altre informazioni sulle utilità di installazione, vedere Installutil.exe (strumento di installazione).
Per installare una coda, creare una classe del programma di installazione del progetto che eredita da Installere impostare per RunInstallerAttribute la classe su true. All'interno del progetto creare un'istanza MessageQueueInstaller per ogni coda nell'installazione e aggiungere l'istanza alla classe del programma di installazione del progetto.
Quando si crea un'istanza MessageQueueInstaller di , è possibile passare facoltativamente un esistente MessageQueue ,ad esempio da un server di test, al MessageQueueInstaller costruttore . Questo approccio fornisce automaticamente le impostazioni di configurazione per la nuova coda eseguendo il mirroring delle impostazioni della coda passate. In alternativa, è possibile impostare manualmente le proprietà nell'istanza MessageQueueInstaller degli stati desiderati e chiamare il costruttore senza parametri.
Quando viene chiamato l'utilità di installazione, cerca .RunInstallerAttribute Se è true, l'utilità installa tutte le code nella Installers raccolta associata al programma di installazione del progetto. Se RunInstallerAttribute è false, l'utilità ignora il programma di installazione del progetto.
È possibile modificare altre proprietà di un'istanza MessageQueueInstaller prima o dopo l'aggiunta dell'istanza Installers alla raccolta del programma di installazione del progetto. Ad esempio, è necessario impostare una coda prima dell'esecuzione Path dell'utilità di installazione.
In genere, non si chiamano i metodi dell'oggetto MessageQueueInstaller dall'interno del codice, ma in genere vengono chiamati solo dall'utilità di installazione installutil.exe. L'utilità chiama automaticamente il Install metodo durante il processo di installazione e chiama Commit se l'installazione non ha generato un'eccezione. Restituisce gli errori, se necessario, chiamando Rollback per l'oggetto che ha generato l'eccezione.
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 vengono aggiornate continuamente quando ogni MessageQueueInstaller istanza viene installata dall'utilità . In genere non è necessario che il codice modifichi in modo esplicito le informazioni sullo stato.
Costruttori
| Nome | Descrizione |
|---|---|
| MessageQueueInstaller() |
Inizializza una nuova istanza della classe MessageQueueInstaller. Non imposta alcuna proprietà dell'istanza. |
| MessageQueueInstaller(MessageQueue) |
Inizializza una nuova istanza della MessageQueueInstaller classe , inizializzando le impostazioni di installazione in quelle di un'istanza esistente MessageQueue . |
Proprietà
| Nome | Descrizione |
|---|---|
| Authenticate |
Ottiene o imposta un valore che indica se la coda da installare accetta solo messaggi autenticati. |
| BasePriority |
Ottiene o imposta la priorità di base utilizzata per instradare i messaggi di una coda pubblica in rete. |
| CanRaiseEvents |
Ottiene un valore che indica se il componente può generare un evento. (Ereditato da Component) |
| Category |
Ottiene o imposta un tipo di coda specifico dell'implementazione. |
| Container |
Ottiene l'oggetto IContainer contenente l'oggetto Component. (Ereditato da Component) |
| Context |
Ottiene o imposta informazioni sull'installazione corrente. (Ereditato da Installer) |
| DesignMode |
Ottiene un valore che indica se è Component attualmente in modalità progettazione. (Ereditato da Component) |
| EncryptionRequired |
Ottiene o imposta un valore che indica se la coda accetta solo messaggi privati o crittografati. |
| Events |
Ottiene l'elenco dei gestori eventi associati a questo Componentoggetto . (Ereditato da Component) |
| HelpText |
Ottiene il testo della Guida per tutti i programmi di installazione nella raccolta del programma di installazione. (Ereditato da Installer) |
| Installers |
Ottiene la raccolta di programmi di installazione contenuti nel programma di installazione. (Ereditato da Installer) |
| Label |
Ottiene o imposta una descrizione della coda. |
| MaximumJournalSize |
Ottiene o imposta la dimensione massima del journal associato alla coda. |
| MaximumQueueSize |
Ottiene o imposta le dimensioni massime della coda. |
| MulticastAddress |
Introdotto in MSMQ 3.0. Ottiene o imposta l'indirizzo multicast associato alla coda. |
| Parent |
Ottiene o imposta il programma di installazione contenente la raccolta a cui appartiene il programma di installazione. (Ereditato da Installer) |
| Path |
Ottiene o imposta la posizione della coda a cui fa riferimento questo oggetto. |
| Permissions |
Ottiene o imposta le autorizzazioni associate alla coda. |
| Site |
Ottiene o imposta il ISite del Component. (Ereditato da Component) |
| Transactional |
Ottiene o imposta un valore che indica se la coda accetta solo i messaggi inviati come parte di una transazione. |
| UninstallAction |
Ottiene o imposta un valore che indica le operazioni del programma di installazione con la coda in fase di disinstallazione: rimuoverlo, ripristinarlo nello stato di preinstallazione o lasciarlo nello stato di installazione corrente. |
| UseJournalQueue |
Ottiene o imposta un valore che indica se i messaggi recuperati dalla coda vengono copiati anche nella coda del journal associata. |
Metodi
| Nome | Descrizione |
|---|---|
| Commit(IDictionary) |
Completa il processo di installazione eseguendo il commit delle MessageQueue informazioni di installazione scritte Install(IDictionary) dal metodo nel Registro di sistema. Questo metodo è progettato per essere usato dagli strumenti di installazione, che chiamano automaticamente i metodi appropriati. |
| CopyFromComponent(IComponent) |
Copia i valori delle proprietà di un MessageQueue componente necessari in fase di installazione per una coda di messaggi. |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| Dispose() |
Rilascia tutte le risorse usate da Component. (Ereditato da Component) |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate da Component e, facoltativamente, rilascia le risorse gestite. (Ereditato da Component) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetService(Type) |
Restituisce un oggetto che rappresenta un servizio fornito da Component o da Container. (Ereditato da Component) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| Install(IDictionary) |
Esegue l'installazione e scrive le informazioni della coda dei messaggi nel Registro di sistema. Questo metodo è progettato per essere usato dagli strumenti di installazione, che chiamano automaticamente i metodi appropriati. |
| IsEquivalentInstaller(ComponentInstaller) |
Determina se il programma di installazione specificato può gestire lo stesso tipo di installazione del programma di installazione. |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| OnAfterInstall(IDictionary) |
Genera l'evento AfterInstall. (Ereditato da Installer) |
| OnAfterRollback(IDictionary) |
Genera l'evento AfterRollback. (Ereditato da Installer) |
| OnAfterUninstall(IDictionary) |
Genera l'evento AfterUninstall. (Ereditato da Installer) |
| OnBeforeInstall(IDictionary) |
Genera l'evento BeforeInstall. (Ereditato da Installer) |
| OnBeforeRollback(IDictionary) |
Genera l'evento BeforeRollback. (Ereditato da Installer) |
| OnBeforeUninstall(IDictionary) |
Genera l'evento BeforeUninstall. (Ereditato da Installer) |
| OnCommitted(IDictionary) |
Genera l'evento Committed. (Ereditato da Installer) |
| OnCommitting(IDictionary) |
Genera l'evento Committing. (Ereditato da Installer) |
| Rollback(IDictionary) |
Ripristina lo stato del computer in cui si trovava prima dell'installazione, eseguendo il rollback delle informazioni sulla coda scritte nel Registro di sistema dalla procedura di installazione. Questo metodo è progettato per essere usato dagli strumenti di installazione, che chiamano automaticamente i metodi appropriati. |
| ToString() |
Restituisce un oggetto String contenente il nome dell'oggetto Component, se presente. Questo metodo non deve essere sottoposto a override. (Ereditato da Component) |
| Uninstall(IDictionary) |
Rimuove un'installazione rimuovendo le informazioni sulla coda dal Registro di sistema. Questo metodo è progettato per essere usato dagli strumenti di disinstallazione, che chiamano automaticamente i metodi appropriati. |
Eventi
| Nome | Descrizione |
|---|---|
| AfterInstall |
Si verifica dopo l'esecuzione Install(IDictionary) dei metodi di tutti i programmi di installazione nella Installers proprietà . (Ereditato da Installer) |
| AfterRollback |
Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione nella Installers proprietà . (Ereditato da Installer) |
| AfterUninstall |
Si verifica dopo che tutti i programmi di installazione nella Installers proprietà eseguono le operazioni di disinstallazione. (Ereditato da Installer) |
| BeforeInstall |
Si verifica prima dell'esecuzione Install(IDictionary) del metodo di ogni programma di installazione nella raccolta del programma di installazione. (Ereditato da Installer) |
| BeforeRollback |
Si verifica prima del rollback dei programmi di installazione nella Installers proprietà . (Ereditato da Installer) |
| BeforeUninstall |
Si verifica prima che i programmi di installazione nella Installers proprietà eseguano le operazioni di disinstallazione. (Ereditato da Installer) |
| Committed |
Si verifica dopo che tutti i programmi di installazione nella proprietà hanno eseguito il Installers commit delle installazioni. (Ereditato da Installer) |
| Committing |
Si verifica prima che i programmi di installazione nella proprietà eseseguono il commit delle Installers installazioni. (Ereditato da Installer) |
| Disposed |
Si verifica quando il componente viene eliminato da una chiamata al Dispose() metodo . (Ereditato da Component) |