MessageQueueInstaller Classe

Definizione

Spazio dei nomi:

System.Messaging

Assembly:

System.Messaging.dll

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::ComponentInstaller

public class MessageQueueInstaller : System.Configuration.Install.ComponentInstaller

type MessageQueueInstaller = class
    inherit ComponentInstaller

Public Class MessageQueueInstaller
Inherits ComponentInstaller

Ereditarietà

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

MessageQueueInstaller

Commenti

L'oggetto MessageQueueInstaller viene utilizzato 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 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 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 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 aver aggiunto l'istanza alla Installers 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 vengono in genere 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 backup degli 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 perché ogni MessageQueueInstaller istanza viene installata dall'utilità . Non è in genere necessario che il codice modifichi 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()	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()	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)

Vedi anche

• Installutil.exe (Strumento Programma di installazione)