ServiceProcessInstaller Класс

Определение

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

public class ServiceProcessInstaller : System.Configuration.Install.ComponentInstaller

type ServiceProcessInstaller = class
    inherit ComponentInstaller

Public Class ServiceProcessInstaller
Inherits ComponentInstaller

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

Object

MarshalByRefObject

Component

Installer

ComponentInstaller

ServiceProcessInstaller

Примеры

В следующем примере создается установщик проекта с именем 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

Комментарии

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

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

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

Для экземпляра ServiceProcessInstallerсвойства можно изменить, в том числе указать, что приложение службы выполняется под учетной записью, отличной от вошедшего пользователя. Можно указать определенную Username пару и Password , под которой должна выполняться служба, или Account использовать для указания того, что служба выполняется под системной учетной записью компьютера, локальной или сетевой учетной записью службы или учетной записью пользователя.

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

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

Создание экземпляра ServiceProcessInstaller приводит к вызову конструктора ComponentInstallerбазового класса , .

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

Свойства

Методы

События

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

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

• ServiceInstaller
• ServiceBase
• ComponentInstaller
• Installers
• ServiceAccount
• ServiceInstallerDialog