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 программа ищет классы в сборке службы с заданным значением RunInstallerAttributetrue. Добавьте классы в сборку службы, добавив их в 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