MessageQueueInstaller Classe

Definizione

Consente di installare e configurare una coda necessaria all'esecuzione dell'applicazione.Allows you to install and configure a queue that your application needs in order to run. Questa classe viene chiamata dall'utilità di installazione, ad esempio InstallUtil.exe, durante l'installazione di un oggetto MessageQueue.This class is called by the installation utility, for example, InstallUtil.exe, when installing a 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à

Commenti

Il MessageQueueInstaller viene utilizzato dall'utilità di installazione per scrivere i valori del registro di sistema associati alla coda.The MessageQueueInstaller is used by the installation utility to write registry values that are associated with the queue. Per ulteriori informazioni sulle utilità di installazione, vedere installutil. exe (utilità di installazione).For more information about installation utilities, see Installutil.exe (Installer Tool).

Per installare una coda, creare una classe del programma di installazione del progetto Installerche eredita da e RunInstallerAttribute impostare per la classe truesu.To install a queue, create a project installer class that inherits from the Installer, and set the RunInstallerAttribute for the class to true. All'interno del progetto, creare MessageQueueInstaller un'istanza per ogni coda nell'installazione e aggiungere l'istanza alla classe del programma di installazione del progetto.Within your project, create a MessageQueueInstaller instance for each queue in the installation and add the instance to your project installer class.

Quando si crea MessageQueueInstaller un'istanza di, è possibile passare al MessageQueueInstaller costruttore MessageQueue un oggetto esistente (ad esempio, da un server di prova).When creating a MessageQueueInstaller instance, you can optionally pass an existing MessageQueue (for example, from a test server) to the MessageQueueInstaller constructor. Questo approccio fornisce automaticamente le impostazioni di configurazione per la nuova coda mediante il mirroring delle impostazioni della coda passata.This approach automatically provides the configuration settings for the new queue by mirroring the settings of the queue passed in. In alternativa, è possibile impostare manualmente le proprietà MessageQueueInstaller dell'istanza sugli stati desiderati e chiamare il costruttore senza parametri.Alternatively, you can manually set the properties in the MessageQueueInstaller instance to the states you want and call the parameterless constructor.

Quando viene chiamata l'utilità di installazione, viene eseguita la RunInstallerAttributericerca di.When the install utility is called, it looks for the RunInstallerAttribute. In caso contrario true, l'utilità installa tutte le code della raccoltaassociataalprogrammadiInstallers installazione del progetto.If it is true, the utility installs all the queues in the Installers collection associated with your project installer. Se RunInstallerAttribute èfalse, l'utilità ignora il programma di installazione del progetto.If RunInstallerAttribute is false, the utility ignores the project installer.

È possibile modificare altre proprietà di MessageQueueInstaller un'istanza prima o dopo l'aggiunta dell'istanza Installers alla raccolta del programma di installazione del progetto.You modify other properties of a MessageQueueInstaller instance either before or after adding the instance to the Installers collection of your project installer. È necessario, ad esempio, Path impostare una coda prima di eseguire l'utilità di installazione.For example, a queue's Path must be set before the install utility executes.

In genere, non si chiamano i metodi di MessageQueueInstaller dall'interno del codice. vengono in genere chiamati solo dall'utilità di installazione InstallUtil. exe.Typically, you do not call the methods of the MessageQueueInstaller from within your code; they are generally called only by the installutil.exe installation utility. L'utilità chiama automaticamente il Install metodo durante il processo di installazione e Commit chiama se l'installazione non ha generato un'eccezione.The utility automatically calls the Install method during the installation process and calls Commit if the installation did not throw an exception. Viene restituito un errore, se necessario, chiamando Rollback per l'oggetto che ha generato l'eccezione.It backs out failures, if necessary, by calling Rollback for the object that generated the exception.

La routine di installazione di un'applicazione usa il programma Installer.Context di installazione del progetto per gestire automaticamente le informazioni sui componenti che sono già stati installati.An application's install routine uses the project installer's Installer.Context to automatically maintain information about the components that have already been installed. Queste informazioni sullo stato vengono aggiornate continuamente quando MessageQueueInstaller ogni istanza viene installata dall'utilità.This state information is continuously updated as each MessageQueueInstaller instance is installed by the utility. Non è in genere necessario che il codice modifichi in modo esplicito le informazioni sullo stato.It is not usually necessary for your code to explicitly modify the state information.

Costruttori

MessageQueueInstaller()

Inizializza una nuova istanza della classe MessageQueueInstaller.Initializes a new instance of the MessageQueueInstaller class. Non imposta alcuna proprietà dell'istanza.Does not set any instance properties.

MessageQueueInstaller(MessageQueue)

Inizializza una nuova istanza della classe MessageQueueInstaller e inizializza le impostazioni di installazione su quelle di un'istanza MessageQueue esistente.Initializes a new instance of the MessageQueueInstaller class, initializing the installation settings to those of an existing MessageQueue instance.

Proprietà

Authenticate

Ottiene o imposta un valore che indica se la coda da installare accetta solo messaggi autenticati.Gets or sets a value that indicates whether the queue to be installed accepts only authenticated messages.

BasePriority

Ottiene o imposta la priorità di base utilizzata per trasferire i messaggi di una coda pubblica sulla rete.Gets or sets the base priority that is used to route a public queue's messages over the network.

CanRaiseEvents

Ottiene un valore che indica se il componente può generare un evento.Gets a value indicating whether the component can raise an event.

(Ereditato da Component)
Category

Ottiene o imposta un tipo di coda specifico dell'implementazione.Gets or sets an implementation-specific queue type.

Container

Ottiene il IContainer che contiene il Component.Gets the IContainer that contains the Component.

(Ereditato da Component)
Context

Ottiene o imposta le informazioni sull'installazione corrente.Gets or sets information about the current installation.

(Ereditato da Installer)
DesignMode

Ottiene un valore che indica se il Component si trova in modalità progettazione.Gets a value that indicates whether the Component is currently in design mode.

(Ereditato da Component)
EncryptionRequired

Ottiene o imposta un valore che indica se la coda accetta solo messaggi privati (crittografati).Gets or sets a value that indicates whether the queue accepts only private, or encrypted, messages.

Events

Ottiene l'elenco dei gestori eventi allegati a questo Component.Gets the list of event handlers that are attached to this Component.

(Ereditato da Component)
HelpText

Ottiene il testo della Guida per tutti i programmi di installazione dell'insieme Installer.Gets the help text for all the installers in the installer collection.

(Ereditato da Installer)
Installers

Ottiene l'insieme dei programmi di installazione contenuti nel programma.Gets the collection of installers that this installer contains.

(Ereditato da Installer)
Label

Ottiene o imposta una descrizione della coda.Gets or sets a description of the queue.

MaximumJournalSize

Ottiene o imposta la dimensione massima del journal associato alla coda.Gets or sets the maximum size of the journal that is associated with the queue.

MaximumQueueSize

Ottiene o imposta la dimensione massima della coda.Gets or sets the maximum size of the queue.

MulticastAddress

Introdotto in MSMQ 3.0.Introduced in MSMQ 3.0. Ottiene o imposta l'indirizzo multicast associato alla coda.Gets or sets the multicast address associated with the queue.

Parent

Ottiene o imposta il programma di installazione contenente l'insieme cui appartiene questo programma di installazione.Gets or sets the installer containing the collection that this installer belongs to.

(Ereditato da Installer)
Path

Ottiene o imposta la posizione della coda a cui questo oggetto fa riferimento.Gets or sets the location of the queue that is referenced by this object.

Permissions

Ottiene o imposta le autorizzazioni associate alla coda.Gets or sets permissions associated with the queue.

Site

Ottiene o imposta l'oggetto ISite di Component.Gets or sets the ISite of the Component.

(Ereditato da Component)
Transactional

Ottiene o imposta un valore che indica se la coda accetta solo messaggi inviati nell'ambito di una transazione.Gets or sets a value that indicates whether the queue accepts only messages sent as part of a transaction.

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.Gets or sets a value that indicates what the installer does with the queue at uninstall time: remove it, restore it to its pre-installation state, or leave it in its current installed state.

UseJournalQueue

Ottiene o imposta un valore che indica se i messaggi recuperati dalla coda devono essere anche copiati nella coda del journal associata.Gets or sets a value that indicates whether messages that are retrieved from the queue are also copied to the associated journal queue.

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).Completes the installation process by committing the MessageQueue installation information that the Install(IDictionary) method wrote to the registry. Questo metodo è progettato per essere utilizzato dagli strumenti di installazione, che chiamano automaticamente i metodi corretti.This method is meant to be used by installation tools, which automatically call the appropriate methods.

CopyFromComponent(IComponent)

Copia i valori di proprietà di un componente MessageQueue necessari in fase di installazione per una coda di messaggi.Copies the property values of a MessageQueue component that are required at install time for a message queue.

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da Component.Releases all resources used by the Component.

(Ereditato da Component)
Dispose(Boolean)

Rilascia le risorse non gestite usate da Component e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Ereditato da Component)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetService(Type)

Consente di restituire un oggetto che rappresenta un servizio fornito da Component o dal relativo Container.Returns an object that represents a service provided by the Component or by its Container.

(Ereditato da Component)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
Install(IDictionary)

Esegue l'installazione e scrive nel Registro di sistema le informazioni della coda di messaggi.Performs the installation and writes message queue information to the registry. Questo metodo è progettato per essere utilizzato dagli strumenti di installazione, che chiamano automaticamente i metodi corretti.This method is meant to be used by installation tools, which automatically call the appropriate methods.

IsEquivalentInstaller(ComponentInstaller)

Determina se il programma di installazione specificato può gestire lo stesso tipo di installazione del programma di installazione corrente.Determines whether the specified installer can handle the same kind of installation as this installer.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
OnAfterInstall(IDictionary)

Genera l'evento AfterInstall.Raises the AfterInstall event.

(Ereditato da Installer)
OnAfterRollback(IDictionary)

Genera l'evento AfterRollback.Raises the AfterRollback event.

(Ereditato da Installer)
OnAfterUninstall(IDictionary)

Genera l'evento AfterUninstall.Raises the AfterUninstall event.

(Ereditato da Installer)
OnBeforeInstall(IDictionary)

Genera l'evento BeforeInstall.Raises the BeforeInstall event.

(Ereditato da Installer)
OnBeforeRollback(IDictionary)

Genera l'evento BeforeRollback.Raises the BeforeRollback event.

(Ereditato da Installer)
OnBeforeUninstall(IDictionary)

Genera l'evento BeforeUninstall.Raises the BeforeUninstall event.

(Ereditato da Installer)
OnCommitted(IDictionary)

Genera l'evento Committed.Raises the Committed event.

(Ereditato da Installer)
OnCommitting(IDictionary)

Genera l'evento Committing.Raises the Committing event.

(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.Restores the computer to the state it was in before the installation, by rolling back the queue information that the installation procedure wrote to the registry. Questo metodo è progettato per essere utilizzato dagli strumenti di installazione, che chiamano automaticamente i metodi corretti.This method is meant to be used by installation tools, which automatically call the appropriate methods.

ToString()

Restituisce un oggetto String che contiene il nome dell'eventuale oggetto Component.Returns a String containing the name of the Component, if any. Questo metodo non deve essere sottoposto a override.This method should not be overridden.

(Ereditato da Component)
Uninstall(IDictionary)

Rimuove un'installazione rimuovendo le informazioni della coda dal Registro di sistema.Removes an installation by removing queue information from the registry. È necessario che questo metodo venga utilizzato dagli strumenti di disinstallazione, che chiamano automaticamente i metodi corretti.This method is meant to be used by uninstallation tools, which automatically call the appropriate methods.

Eventi

AfterInstall

Viene generato dopo l'esecuzione dei metodi Install(IDictionary) di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after the Install(IDictionary) methods of all the installers in the Installers property have run.

(Ereditato da Installer)
AfterRollback

Si verifica dopo il rollback delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after the installations of all the installers in the Installers property are rolled back.

(Ereditato da Installer)
AfterUninstall

Viene generato dopo l'esecuzione delle operazioni di disinstallazione di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after all the installers in the Installers property perform their uninstallation operations.

(Ereditato da Installer)
BeforeInstall

Si verifica dopo l'esecuzione del metodo Install(IDictionary) di ogni programma di installazione contenuto nella raccolta Installer.Occurs before the Install(IDictionary) method of each installer in the installer collection has run.

(Ereditato da Installer)
BeforeRollback

Viene generato prima del rollback dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property are rolled back.

(Ereditato da Installer)
BeforeUninstall

Viene generato prima dell'esecuzione delle operazioni di disinstallazione dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property perform their uninstall operations.

(Ereditato da Installer)
Committed

Si verifica dopo l'esecuzione del commit delle installazioni di tutti i programmi di installazione contenuti nella proprietà Installers.Occurs after all the installers in the Installers property have committed their installations.

(Ereditato da Installer)
Committing

Si verifica prima dell'esecuzione del commit delle installazioni dei programmi di installazione contenuti nella proprietà Installers.Occurs before the installers in the Installers property commit their installations.

(Ereditato da Installer)
Disposed

Si verifica quando il componente viene eliminato da una chiamata al metodo Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Ereditato da Component)

Si applica a

Vedi anche