ServiceInstaller Класс

Определение

public ref class ServiceInstaller : System::Configuration::Install::ComponentInstaller

public class ServiceInstaller : System.Configuration.Install.ComponentInstaller

type ServiceInstaller = class
    inherit ComponentInstaller

Public Class ServiceInstaller
Inherits ComponentInstaller

Наследование

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceInstaller

Примеры

В следующем примере создается установщик проекта с именем MyProjectInstaller, который наследует от Installer. Предполагается, что существует исполняемый файл службы, содержащий две службы: "Hello-World Service 1" и "Hello-World Service 2". В конструкторе для MyProjectInstaller (который будет вызываться программой установки) ServiceInstaller создаются объекты для каждой из этих служб, а ServiceProcessInstaller для исполняемого файла создается объект . Чтобы программа установки распознала MyProjectInstaller как допустимый установщик, RunInstallerAttribute атрибуту присваивается значение true.

Дополнительные свойства задаются в установщике процесса и установщиках служб перед добавлением установщиков в коллекцию Installers . Когда служебная программа установки обращается MyProjectInstallerк , объекты, добавленные в коллекцию Installers с помощью вызова , InstallerCollection.Add будут установлены в свою очередь. Во время этого процесса установщик сохраняет сведения о состоянии, указывающие, какие объекты были установлены, поэтому при сбое установки можно сделать резервную копию каждого из них по очереди.

Как правило, экземпляр класса установщика проекта не создается явным образом. Вы создадите его и добавьте RunInstallerAttribute атрибут в синтаксис, но это служебная программа установки, которая фактически вызывает и, следовательно, создает экземпляр класса .

#using <System.dll>
#using <System.ServiceProcess.dll>
#using <System.Configuration.Install.dll>

using namespace System;
using namespace System::Collections;
using namespace System::Configuration::Install;
using namespace System::ServiceProcess;
using namespace System::ComponentModel;

[RunInstaller(true)]
public ref class MyProjectInstaller : public Installer
{
private:
    ServiceInstaller^ serviceInstaller1;
    ServiceInstaller^ serviceInstaller2;
    ServiceProcessInstaller^ processInstaller;

public:
    MyProjectInstaller()
    {
        // Instantiate installers for process and services.
        processInstaller = gcnew ServiceProcessInstaller;
        serviceInstaller1 = gcnew ServiceInstaller;
        serviceInstaller2 = gcnew ServiceInstaller;

        // The services run under the system account.
        processInstaller->Account = ServiceAccount::LocalSystem;

        // The services are started manually.
        serviceInstaller1->StartType = ServiceStartMode::Manual;
        serviceInstaller2->StartType = ServiceStartMode::Manual;

        // ServiceName must equal those on ServiceBase derived classes.
        serviceInstaller1->ServiceName = "Hello-World Service 1";
        serviceInstaller2->ServiceName = "Hello-World Service 2";

        // Add installers to collection. Order is not important.
        Installers->Add( serviceInstaller1 );
        Installers->Add( serviceInstaller2 );
        Installers->Add( processInstaller );
    }

    static void Main()
    {
        Console::WriteLine("Usage: InstallUtil.exe [<service>.exe]");
    }
};

int main()
{
    MyProjectInstaller::Main();
}

using System;
using System.Collections;
using System.Configuration.Install;
using System.ServiceProcess;
using System.ComponentModel;

[RunInstaller(true)]
public class MyProjectInstaller : Installer
{
    private ServiceInstaller serviceInstaller1;
    private ServiceInstaller serviceInstaller2;
    private ServiceProcessInstaller processInstaller;

    public MyProjectInstaller()
    {
        // Instantiate installers for process and services.
        processInstaller = new ServiceProcessInstaller();
        serviceInstaller1 = new ServiceInstaller();
        serviceInstaller2 = new ServiceInstaller();

        // The services run under the system account.
        processInstaller.Account = ServiceAccount.LocalSystem;

        // The services are started manually.
        serviceInstaller1.StartType = ServiceStartMode.Manual;
        serviceInstaller2.StartType = ServiceStartMode.Manual;

        // ServiceName must equal those on ServiceBase derived classes.
        serviceInstaller1.ServiceName = "Hello-World Service 1";
        serviceInstaller2.ServiceName = "Hello-World Service 2";

        // Add installers to collection. Order is not important.
        Installers.Add(serviceInstaller1);
        Installers.Add(serviceInstaller2);
        Installers.Add(processInstaller);
    }

    public static void Main()
    {
        Console.WriteLine("Usage: InstallUtil.exe [<service>.exe]");
    }
}

Imports System.Collections
Imports System.Configuration.Install
Imports System.ServiceProcess
Imports System.ComponentModel

<RunInstallerAttribute(True)> _
Public Class MyProjectInstaller
    Inherits Installer
    Private serviceInstaller1 As ServiceInstaller
    Private serviceInstaller2 As ServiceInstaller
    Private processInstaller As ServiceProcessInstaller    
    
    Public Sub New()
        ' Instantiate installers for process and services.
        processInstaller = New ServiceProcessInstaller()
        serviceInstaller1 = New ServiceInstaller()
        serviceInstaller2 = New ServiceInstaller()
        
        ' The services will run under the system account.
        processInstaller.Account = ServiceAccount.LocalSystem
        
        ' The services will be started manually.
        serviceInstaller1.StartType = ServiceStartMode.Manual
        serviceInstaller2.StartType = ServiceStartMode.Manual
        
        ' ServiceName must equal those on ServiceBase derived classes.            
        serviceInstaller1.ServiceName = "Hello-World Service 1"
        serviceInstaller2.ServiceName = "Hello-World Service 2"
        
        ' Add installers to collection. Order is not important.
        Installers.Add(serviceInstaller1)
        Installers.Add(serviceInstaller2)
        Installers.Add(processInstaller)
    End Sub

    Public Shared Sub Main()
        Console.WriteLine("Usage: InstallUtil.exe [<service>.exe]")
    End Sub
End Class

Комментарии

Объект ServiceInstaller работает только для службы, с которой он связан. Он используется программой установки для записи значений реестра, связанных со службой, в подраздел в разделе реестра HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services. Служба идентифицируется по имени службы в этом подразделе. Подраздел также содержит имя исполняемого файла или .dll, к которому принадлежит служба.

Чтобы установить службу, создайте класс установщика проекта, который наследуется от Installer класса , и присвойте RunInstallerAttribute атрибуту класса значение true. В проекте создайте по одному ServiceProcessInstaller экземпляру для каждого приложения-службы и по одному ServiceInstaller экземпляру для каждой службы в приложении. В конструкторе класса установщика проекта задайте свойства установки для службы с помощью ServiceProcessInstaller экземпляров и ServiceInstaller и добавьте экземпляры в коллекцию Installers .

Для всех классов, производных Installers от Installer класса , состояние коллекции должно быть одинаковым в методах Install и Uninstall . Однако можно избежать обслуживания коллекции Install в методах и Uninstall , если добавить экземпляры установщика в коллекцию Installers в конструкторе пользовательского класса установщика. При вызове программы установки она ищет RunInstallerAttribute атрибут . Если атрибут имеет значение true, служебная программа устанавливает все службы, добавленные в коллекцию Installers , связанную с установщиком проекта. Если RunInstallerAttribute имеет значение false или не существует, служебная программа установки игнорирует установщик проекта.

Объект , связанный ServiceProcessInstaller с классом установки проекта, содержит сведения об установке, общие для всех ServiceInstaller экземпляров проекта. Если у этой службы есть что-то, что отделяет ее от других служб в проекте установки, эта информация о службе устанавливается этим методом.

Вы можете изменить другие свойства в до ServiceInstaller или после добавления его в коллекцию Installers установщика проекта. Например, служба может быть настроена StartType на автоматический запуск службы при перезагрузке или требовать от пользователя запуска службы вручную.

Как правило, методы не вызываются в коде ServiceInstaller . Обычно они вызываются только программой установки. Служебная программа установки автоматически вызывает методы ServiceProcessInstaller.Install и ServiceInstaller.Install в процессе установки. При необходимости он возвращает сбои путем вызова Rollback (или ServiceInstaller.Rollback) для всех ранее установленных компонентов.

Служебная программа установки вызывает Uninstall для удаления объекта .

Подпрограмма установки приложения автоматически сохраняет сведения об уже установленных компонентах с помощью установщика Installer.Contextпроекта . Эта информация о состоянии постоянно обновляется как ServiceProcessInstaller экземпляр, и каждый ServiceInstaller экземпляр устанавливается служебной программой. Обычно коду не требуется явно изменять сведения о состоянии.

При установке автоматически создается EventLogInstaller для установки источника журнала событий, связанного с производным классом ServiceBase . Свойство Log для этого источника задается конструктором ServiceInstaller в журнале приложений компьютера. При установке ServiceName объекта ServiceInstaller (который должен быть идентичен свойству ServiceBase.ServiceName службы) Source автоматически присваивается то же значение. При сбое установки происходит откат установки источника вместе с ранее установленными службами.

Метод Uninstall пытается остановить службу, если она запущена. Независимо от того, успешно это или нет, отменяет изменения, Uninstall внесенные .Install Если для ведения журнала событий был создан новый источник, он удаляется.

Конструкторы

Свойства

Методы

События

Применяется к

См. также раздел

• ServiceName
• ServiceProcessInstaller
• ServiceBase
• EventLog