MessageQueueInstaller.Install(IDictionary) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Realiza la instalación y escribe la información de la cola de mensajes en el Registro. Este método está pensado para que lo utilicen las herramientas de instalación, que llaman automáticamente a los métodos adecuados.
public:
override void Install(System::Collections::IDictionary ^ stateSaver);public override void Install (System.Collections.IDictionary stateSaver);override this.Install : System.Collections.IDictionary -> unitPublic Overrides Sub Install (stateSaver As IDictionary)Parámetros
- stateSaver
- IDictionary
Un objeto IDictionary que se utiliza para guardar la información necesaria para realizar una operación de confirmar, deshacer o desinstalar.
Comentarios
El Install método escribe información de cola de mensajes en el Registro y asocia la MessageQueue instancia a una cola que se encuentra en la ruta de acceso especificada por la Path propiedad . Si la cola aún no existe, Install crea una cola transaccional. Installestablece las propiedades de cola nuevas o existentes en las que ha especificado en .MessageQueueInstaller Si la cola ya existe, sus propiedades se restablecen a las de MessageQueueInstaller. Si la cola existente no es transaccional, se elimina y, a continuación, se vuelve a crear como una cola transaccional.
Precaución
Si es necesario volver a crear la cola, se perderán los mensajes de la cola.
Normalmente, no se llama a los métodos del desde dentro MessageQueueInstaller del código; por lo general, solo la utilidad de instalación de installutil.exe llama a ellos. La utilidad llama automáticamente al Install método durante el proceso de instalación para escribir información del Registro asociada a la cola de mensajes que se está instalando. La instalación es transaccional, por lo que si se produce un error en cualquier componente de proyecto de instalación durante la instalación, todos los componentes instalados anteriormente se revierten a sus estados de preinstalación. Esto se logra llamando al método de Rollback cada componente.
Después de que se haya producido una instalación correcta de todos los componentes asociados al proyecto de instalación, la utilidad de instalación confirma las instalaciones. Commit completa la instalación de MessageQueue estableciendo la cola en el estado inicial adecuado. Si la cola especificada por la Path propiedad ya existe y contiene mensajes, Commit borra los mensajes. Commit, en lugar de Install, borra los mensajes porque no se puede revertir el acto de purgar los mensajes.
La rutina de instalación de una aplicación usa el instalador Installer.Context del proyecto para mantener automáticamente información sobre los componentes que ya se han instalado. Esta información de estado, que se pasa a Install como stateSaver parámetro, se actualiza continuamente a medida que la utilidad instala cada MessageQueueInstaller instancia. Normalmente, no es necesario que el código modifique explícitamente esta información de estado.
