Udostępnij za pośrednictwem

Porady: tworzenie usług systemu Windows

  • Artykuł

Uwaga

Ten artykuł nie dotyczy hostowanych usług na platformie .NET. Aby uzyskać najnowszą zawartość w usługach systemu Windows przy użyciu Microsoft.Extensions.Hosting.BackgroundService i szablonie usługi procesu roboczego, zobacz:

Podczas tworzenia usługi można użyć szablonu projektu programu Visual Studio o nazwie Usługa systemu Windows. Ten szablon automatycznie wykonuje większość pracy, odwołując się do odpowiednich klas i przestrzeni nazw, konfigurowania dziedziczenia z klasy bazowej dla usług i przesłaniania kilku metod, które prawdopodobnie chcesz zastąpić.

Ostrzeżenie

Szablon projektu Usługi systemu Windows nie jest dostępny w wersji Express programu Visual Studio.

Aby co najmniej utworzyć usługę funkcjonalną, musisz:

  • ServiceName Ustaw właściwość .

  • Utwórz niezbędne instalatory dla aplikacji usługi.

  • Zastąpij i określ kod metod OnStart i OnStop , aby dostosować sposoby działania usługi.

Aby utworzyć aplikację usługi systemu Windows

  1. Utwórz projekt usługi systemu Windows.

    Uwaga

    Aby uzyskać instrukcje dotyczące pisania usługi bez używania szablonu, zobacz Jak programowo pisać usługi.

  2. W oknie Właściwości ustaw ServiceName właściwość usługi.

    Ustaw właściwość ServiceName.

    Uwaga

    Wartość ServiceName właściwości musi być zawsze zgodna z nazwą zarejestrowaną w klasach instalatora. Jeśli zmienisz tę właściwość, musisz również zaktualizować ServiceName właściwość klas instalatora.

  3. Ustaw dowolną z poniższych właściwości, aby określić sposób działania usługi.

    Właściwości Ustawienie
    CanStop True aby wskazać, że usługa będzie akceptować żądania zatrzymania działania; false aby zapobiec zatrzymaniu usługi.
    CanShutdown True aby wskazać, że usługa chce otrzymywać powiadomienia, gdy komputer, na którym się znajduje, zostanie zamknięty, umożliwiając mu wywołanie OnShutdown procedury.
    CanPauseAndContinue True aby wskazać, że usługa będzie akceptować żądania wstrzymania lub wznowienia działania; false aby zapobiec wstrzymaniu i wznowieniu działania usługi.
    CanHandlePowerEvent True aby wskazać, że usługa może obsługiwać powiadomienia o zmianach stanu zasilania komputera; false aby zapobiec powiadomieniu usługi o tych zmianach.
    AutoLog True w celu zapisania wpisów informacyjnych w dzienniku zdarzeń aplikacji podczas wykonywania akcji przez usługę; false aby wyłączyć tę funkcję. Aby uzyskać więcej informacji, zobacz Instrukcje: rejestrowanie informacji o usługach. Uwaga: domyślnie AutoLog jest ustawiona wartość true.

    Uwaga

    CanPauseAndContinue Gdy CanStop program Service Control Manager wyłączy odpowiednie opcje menu, aby zatrzymać, wstrzymać lub kontynuować usługę, gdy zostanie ustawiona wartość lub zostanie ustawiona falsena wartość .

  4. Uzyskaj dostęp do Edytora kodu i wypełnij żądane przetwarzanie dla procedur OnStart i OnStop .

  5. Zastąpi wszelkie inne metody, dla których chcesz zdefiniować funkcje.

  6. Dodanie niezbędnych instalatorów dla aplikacji usługi. Aby uzyskać więcej informacji, zobacz How to: Add Installers to Your Service Application (Instrukcje: dodawanie instalatorów do aplikacji usługi).

  7. Skompiluj projekt, wybierając pozycję Kompiluj rozwiązanie z menu Kompilacja .

    Uwaga

    Nie naciskaj klawisza F5, aby uruchomić projekt — w ten sposób nie można uruchomić projektu usługi.

  8. Zainstaluj usługę. Aby uzyskać więcej informacji, zobacz Instrukcje: instalowanie i odinstalowywanie usług.

Zobacz też