Como: Adicionar instaladores ao seu aplicativo de serviço

O Visual Studio fornece componentes de instalação que podem instalar recursos associados aos seus aplicativos de serviço. Os componentes de instalação registram um serviço individual no sistema no qual ele está sendo instalado e informam ao Gerenciador de Controle de Serviços que o serviço existe. Ao trabalhar com um aplicativo de serviço, você pode selecionar um link na janela Propriedades para adicionar automaticamente os instaladores apropriados ao seu projeto.

Quando você adiciona um instalador ao seu projeto, uma nova classe (que, por padrão, é chamada ProjectInstaller) é criada no projeto e instâncias dos componentes de instalação apropriados são criadas dentro dele. Essa classe atua como um ponto central para todos os componentes de instalação de que seu projeto precisa. Por exemplo, se você adicionar um segundo serviço ao seu aplicativo e clicar no link Adicionar instalador, uma segunda classe de instalador não será criada; em vez disso, o componente de instalação adicional necessário para o segundo serviço é adicionado à classe existente.

Você não precisa fazer nenhuma codificação especial dentro dos instaladores para fazer com que seus serviços sejam instalados corretamente. No entanto, ocasionalmente pode ser necessário modificar o conteúdo dos instaladores se precisar adicionar funcionalidade especial ao processo de instalação.

Para adicionar instaladores ao seu aplicativo de serviço

1. No Gerenciador de Soluções, acesse o modo Design para o serviço ao qual você deseja adicionar um componente de instalação.

2. Clique no plano de fundo do designer para selecionar o serviço em si, em vez de qualquer um de seus conteúdos.

3. Com o designer em foco, clique com o botão direito do mouse e clique em Adicionar instalador.

   Uma nova classe, ProjectInstaller, e dois componentes de instalação, ServiceProcessInstaller e ServiceInstaller, são adicionados ao seu projeto, e os valores de propriedade para o serviço são copiados para os componentes.

4. Clique no ServiceInstaller componente e verifique se o valor da ServiceName propriedade está definido como o mesmo valor que a ServiceName propriedade no próprio serviço.

5. Para determinar como o serviço será iniciado, clique no ServiceInstaller componente e defina a StartType propriedade para o valor apropriado.

   Value	Result
   Manual	O serviço deve ser iniciado manualmente após a instalação. Para obter mais informações, consulte Como iniciar serviços.
   Automatic	O serviço será iniciado sozinho sempre que o computador for reiniciado.
   Disabled	O serviço não pode ser iniciado.

6. Para determinar o contexto de segurança no qual o serviço será executado, clique ServiceProcessInstaller no componente e defina os valores de propriedade apropriados. Para obter mais informações, consulte Como especificar o contexto de segurança para serviços.

7. Substitua todos os métodos para os quais você precisa executar o processamento personalizado.

8. Execute as etapas de 1 a 7 para cada serviço adicional em seu projeto.

   Nota

   Para cada serviço adicional em seu projeto, você deve adicionar um componente adicional ServiceInstaller à classe do ProjectInstaller projeto. O ServiceProcessInstaller componente adicionado na etapa três funciona com todos os instaladores de serviço individuais no projeto.

Consulte também

• Introdução aos aplicativos de serviço do Windows
• Como: Instalar e desinstalar serviços
• Como: Iniciar serviços
• Como: Especificar o contexto de segurança para serviços