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 all'esecuzione dell'applicazione. Questa classe viene chiamata dall'utilità di installazione, ad esempio InstallUtil.exe, durante l'installazione di un oggetto 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
L'oggetto MessageQueueInstaller viene usato dall'utilità di installazione per scrivere 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 la RunInstallerAttribute 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 MessageQueueInstallerMessageQueueInstaller, è possibile passare facoltativamente un esistente MessageQueue (ad esempio, da un server di test) al costruttore. Questo approccio fornisce automaticamente le impostazioni di configurazione per la nuova coda eseguendo il mirroring delle impostazioni della coda passata. In alternativa, è possibile impostare manualmente le proprietà nell'istanza MessageQueueInstaller degli stati desiderati e chiamare il costruttore senza parametri.
Quando viene chiamata l'utilità di installazione, cerca .RunInstallerAttribute Se è true, l'utilità installa tutte le code nella raccolta associata al Installers 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 alla Installers raccolta del programma di installazione del progetto. Ad esempio, è necessario impostare una coda prima dell'esecuzione dell'utilità Path di installazione.
In genere, non si chiamano i metodi dell'oggetto MessageQueueInstaller dall'interno del codice. 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. Esegue il backout degli errori, se necessario, chiamando Rollback l'oggetto che ha generato l'eccezione.
La routine di installazione di un'applicazione usa il programma di Installer.Context installazione del 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à. Non è in genere necessario per il codice modificare in modo esplicito le informazioni sullo stato.
Costruttori
| MessageQueueInstaller() |
Inizializza una nuova istanza della classe MessageQueueInstaller. Non imposta alcuna proprietà dell'istanza. |
| MessageQueueInstaller(MessageQueue) |
Inizializza una nuova istanza della classe MessageQueueInstaller e inizializza le impostazioni di installazione su quelle di un'istanza MessageQueue esistente. |
Proprietà
| 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 trasferire i messaggi di una coda pubblica sulla 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 che contiene Component. (Ereditato da Component) |
| Context |
Ottiene o imposta le informazioni sull'installazione corrente. (Ereditato da Installer) |
| DesignMode |
Ottiene un valore che indica se il Component si trova in modalità progettazione. (Ereditato da Component) |
| EncryptionRequired |
Ottiene o imposta un valore che indica se la coda accetta solo messaggi privati (crittografati). |
| Events |
Ottiene l'elenco dei gestori eventi allegati a questo Component. (Ereditato da Component) |
| HelpText |
Ottiene il testo della Guida per tutti i programmi di installazione della raccolta Installer. (Ereditato da Installer) |
| Installers |
Ottiene la raccolta dei programmi di installazione contenuti nel programma. (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 la dimensione massima 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 cui appartiene questo programma di installazione. (Ereditato da Installer) |
| Path |
Ottiene o imposta la posizione della coda a cui questo oggetto fa riferimento. |
| Permissions |
Ottiene o imposta le autorizzazioni associate alla coda. |
| Site |
Ottiene o imposta l'oggetto ISite di Component. (Ereditato da Component) |
| Transactional |
Ottiene o imposta un valore che indica se la coda accetta solo messaggi inviati nell'ambito di una transazione. |
| UninstallAction |
Ottiene o imposta un valore che indica le operazioni eseguite per la coda dal programma di installazione in fase di disinstallazione: rimozione, ripristino dello stato precedente l'installazione o mantenimento dello stato di installazione corrente. |
| UseJournalQueue |
Ottiene o imposta un valore che indica se i messaggi recuperati dalla coda devono essere anche copiati nella coda del journal associata. |
Metodi
| Commit(IDictionary) |
Completa il processo di installazione tramite il commit delle informazioni di installazione della MessageQueue scritte nel Registro di sistema dal metodo Install(IDictionary). Questo metodo è progettato per essere utilizzato dagli strumenti di installazione, che chiamano automaticamente i metodi corretti. |
| CopyFromComponent(IComponent) |
Copia i valori di proprietà di un componente MessageQueue necessari in fase di installazione per una coda di messaggi. |
| CreateObjRef(Type) |
Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione 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, 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() |
Obsoleti.
Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza. (Ereditato da MarshalByRefObject) |
| GetService(Type) |
Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container. (Ereditato da Component) |
| GetType() |
Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Obsoleti.
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 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. |
| IsEquivalentInstaller(ComponentInstaller) |
Determina se il programma di installazione specificato può gestire lo stesso tipo di installazione del programma di installazione corrente. |
| MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente. (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 il computer allo stato precedente l'installazione, ripristinando le informazioni della coda scritte nel Registro di sistema durante la procedura di installazione. Questo metodo è progettato per essere utilizzato dagli strumenti di installazione, che chiamano automaticamente i metodi corretti. |
| ToString() |
Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component. Questo metodo non deve essere sottoposto a override. (Ereditato da Component) |
| Uninstall(IDictionary) |
Rimuove un'installazione rimuovendo le informazioni della coda dal Registro di sistema. È necessario che questo metodo venga utilizzato dagli strumenti di disinstallazione, che chiamano automaticamente i metodi corretti. |
Eventi
| AfterInstall |
Si verifica dopo l'esecuzione dei metodi Install(IDictionary) di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer) |
| AfterRollback |
Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer) |
| AfterUninstall |
Si verifica dopo l'esecuzione delle operazioni di disinstallazione di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer) |
| BeforeInstall |
Si verifica dopo l'esecuzione del metodo Install(IDictionary) di ogni programma di installazione contenuto nella raccolta Installer. (Ereditato da Installer) |
| BeforeRollback |
Si verifica prima del rollback dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer) |
| BeforeUninstall |
Si verifica prima dell'esecuzione delle operazioni di disinstallazione dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer) |
| Committed |
Si verifica dopo l'esecuzione del commit delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer) |
| Committing |
Si verifica prima dell'esecuzione del commit delle installazioni dei programmi di installazione contenuti nella proprietà Installers. (Ereditato da Installer) |
| Disposed |
Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose(). (Ereditato da Component) |
