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 時，會接著安裝透過 呼叫 InstallerCollection.Add 新增至集合的物件 Installers 。 在程式期間，安裝程式會維護狀態資訊，指出已安裝哪些物件，因此，如果發生安裝失敗，就可以輪流備份每個物件。

一般而言，您不會明確建立專案安裝程式類別的實例。 您會建立它並將 屬性新增 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登錄機碼內的子機碼。 此服務是由此子機碼內的 ServiceName 所識別。 子機碼也包含服務所屬可執行檔或.dll的名稱。

若要安裝服務，請建立繼承自 Installer 類別的專案安裝程式類別，並將 類別上的 屬性設定 RunInstallerAttribute 為 true 。 在您的專案中，為每個服務應用程式建立一個 ServiceProcessInstaller 實例，以及應用程式中每個服務的一個 ServiceInstaller 實例。 在專案安裝程式類別建構函式內，使用 ServiceProcessInstaller 和 ServiceInstaller 實例設定服務的安裝屬性，並將實例新增至 Installers 集合。

針對衍生自 Installer 類別的所有類別，集合的狀態 Installers 在 和 Uninstall 方法中 Install 必須相同。 不過，如果您將安裝程式實例新增至 Installers 自訂安裝程式類別建構函式中的集合 Install ，您可以避免跨 和 Uninstall 方法維護集合。呼叫安裝公用程式時，它會尋找 RunInstallerAttribute 屬性。 如果 屬性為 true ，公用程式會安裝已新增至 Installers 與專案安裝程式相關聯之集合的所有服務。 如果 RunInstallerAttribute 為 false 或 不存在，則安裝公用程式會忽略專案安裝程式。

與專案安裝類別相關聯的 會 ServiceProcessInstaller 安裝專案中所有 ServiceInstaller 實例通用的資訊。 如果此服務具有與安裝專案中其他服務分開的任何專案，則此方法會安裝該服務特定資訊。

您可以在將它新增至 Installers 專案安裝程式的集合之前或之後修改其他屬性 ServiceInstaller 。 例如， StartType 服務可能會設定為在重新開機時自動啟動服務，或要求使用者手動啟動服務。

一般而言，您不會在程式碼中呼叫 方法 ServiceInstaller ;它們通常只能由安裝公用程式呼叫。 安裝公用程式會在安裝程式期間自動呼叫 ServiceProcessInstaller.Install 和 ServiceInstaller.Install 方法。 如有必要，它會在所有先前安裝的元件上呼叫 Rollback (或 ServiceInstaller.Rollback) ，來回複失敗。

安裝公用程式會呼叫 Uninstall 以移除 物件。

應用程式的安裝常式會使用專案安裝程式 Installer.Context 的 自動維護已安裝元件的相關資訊。 此狀態資訊會持續更新為 ServiceProcessInstaller 實例，而且每個 ServiceInstaller 實例都是由 公用程式安裝。 您的程式碼通常不需要明確修改狀態資訊。

執行安裝時，會自動建立 ， EventLogInstaller 以安裝與 ServiceBase 衍生類別相關聯的事件記錄檔來源。 Log這個來源的屬性是由 ServiceInstaller 建構函式設定為電腦的 [應用程式記錄檔]。 當您設定 ServiceNameServiceInstaller 應該與 ServiceBase.ServiceName 服務) 相同之 (的 時， Source 會自動將 設定為相同的值。 在安裝失敗中，來源的安裝會與先前安裝的服務一起復原。

如果服務正在執行，此方法 Uninstall 會嘗試停止服務。 不論這是否成功， Uninstall 請復原 所做的 Install 變更。 如果為事件記錄建立新的來源，則會刪除來源。

建構函式

屬性

方法

事件

適用於

另請參閱

• ServiceName
• ServiceProcessInstaller
• ServiceBase
• EventLog