ServiceInstaller.Install(IDictionary) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Instala o serviço gravando informações do aplicativo de serviço no Registro. Este método destina-se a ser usado pelas ferramentas de instalação, que processam os métodos apropriados automaticamente.
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
Um IDictionary que contém as informações de contexto associadas à instalação.
Exceções
A instalação não contém um ServiceProcessInstaller para o executável.
- ou -
O nome de arquivo para o assembly é null ou uma cadeia de caracteres vazia.
- ou - O nome do servidor é inválido.
- ou - Não foi possível abrir o Gerenciador de Controle de Serviço.
O nome de exibição do serviço tem mais de 255 caracteres.
O sistema não pôde gerar um identificador para o serviço.
- ou -
Um serviço com esse nome já está instalado.
Comentários
Normalmente, você não chamará os métodos em ServiceInstaller dentro de seu código; eles geralmente são chamados apenas pelo utilitário de instalação. O utilitário de instalação chama automaticamente o Install método durante a instalação. Ele faz o back-out de falhas, se necessário, chamando Rollback no objeto que gerou a exceção.
A rotina de instalação de um aplicativo mantém informações automaticamente sobre os componentes que já foram instalados, usando o do instalador do Installer.Context projeto. Essas informações de estado, passadas como o parâmetro , são atualizadas continuamente conforme a instância e cada instância Install é instalada pelo utilitário stateSaver ServiceProcessInstaller ServiceInstaller . Normalmente, é desnecessário que seu código modifique essas informações de estado explicitamente.
O ServiceProcessInstaller associado à classe de instalação do projeto instala informações comuns a todas as ServiceInstaller instâncias do projeto. Se esse serviço tiver algo que o separe dos outros serviços no projeto de instalação, essas informações específicas do serviço serão instaladas por esse método.
Para instalar um serviço, crie uma classe do instalador de projeto que herda da classe e de definido o Installer atributo na classe como RunInstallerAttribute true . Em seu projeto, crie uma ServiceProcessInstaller instância por aplicativo de serviço e uma instância para cada serviço no ServiceInstaller aplicativo. No construtor da classe do instalador do projeto, de definido as propriedades de instalação do serviço usando as instâncias e e adicione as ServiceProcessInstaller ServiceInstaller instâncias à Installers coleção.
Observação
É recomendável que você use o construtor para adicionar instâncias do instalador; no entanto, se você precisar adicionar à coleção no método , certifique-se de executar as mesmas adições à Installers Install coleção no método Uninstall .
Para todas as classes que derivam da classe , o estado da Installer coleção deve ser o mesmo nos métodos e Installers Install Uninstall . No entanto, você pode evitar a manutenção da coleção entre os métodos e se adicionar instâncias do instalador à coleção no construtor de classe do Install Uninstall Installers instalador personalizado.