Delen via

Procedure: Windows Services maken

  • Artikel

Notitie

Dit artikel is niet van toepassing op gehoste services in .NET. Zie voor de nieuwste inhoud van Windows-services die gebruikmaken van Microsoft.Extensions.Hosting.BackgroundService en de worker-servicesjabloon:

Wanneer u een service maakt, kunt u een Visual Studio-projectsjabloon met de naam Windows Service gebruiken. Deze sjabloon doet automatisch veel werk voor u door te verwijzen naar de juiste klassen en naamruimten, het instellen van de overname van de basisklasse voor services en het overschrijven van verschillende methoden die u waarschijnlijk wilt overschrijven.

Waarschuwing

De Windows Services-projectsjabloon is niet beschikbaar in de Express-editie van Visual Studio.

Om minimaal een functionele service te maken, moet u het volgende doen:

  • Stel de ServiceName eigenschap in.

  • Maak de benodigde installatieprogramma's voor uw servicetoepassing.

  • Overschrijven en code opgeven voor de OnStart en OnStop methoden om de manieren waarop uw service zich gedraagt aan te passen.

Een Windows-servicetoepassing maken

  1. Een Windows-serviceproject maken.

    Notitie

    Zie Instructies voor het programmatisch schrijven van services voor instructies over het schrijven van een service zonder de sjabloon.

  2. Stel in het venster Eigenschappen de ServiceName eigenschap voor uw service in.

    Stel de eigenschap ServiceName in.

    Notitie

    De waarde van de ServiceName eigenschap moet altijd overeenkomen met de naam die is vastgelegd in de installatieklassen. Als u deze eigenschap wijzigt, moet u ook de ServiceName eigenschap van installatieklassen bijwerken.

  3. Stel een van de volgende eigenschappen in om te bepalen hoe uw service werkt.

    Eigenschappen Instelling
    CanStop True om aan te geven dat de service aanvragen accepteert om de uitvoering te stoppen; false om te voorkomen dat de service wordt gestopt.
    CanShutdown True om aan te geven dat de service een melding wil ontvangen wanneer de computer waarop deze zich bevindt wordt afgesloten, zodat deze de OnShutdown procedure kan aanroepen.
    CanPauseAndContinue True om aan te geven dat de service aanvragen accepteert om de uitvoering te onderbreken of te hervatten; false om te voorkomen dat de service wordt onderbroken en hervat.
    CanHandlePowerEvent True om aan te geven dat de service meldingen van wijzigingen in de energiestatus van de computer kan verwerken; false om te voorkomen dat de service op de hoogte wordt gesteld van deze wijzigingen.
    AutoLog True om informatieve vermeldingen naar het gebeurtenislogboek van de toepassing te schrijven wanneer uw service een actie uitvoert; false om deze functionaliteit uit te schakelen. Zie Instructies voor meer informatie : Informatie over services vastleggen. Opmerking: standaard AutoLog is ingesteld op true.

    Notitie

    Wanneer CanStop of CanPauseAndContinue zijn ingesteld falseop, schakelt Service Control Manager de bijbehorende menuopties uit om de service te stoppen, te onderbreken of door te zetten.

  4. Open de Code-editor en vul de gewenste verwerking in voor de OnStart en OnStop procedures.

  5. Overschrijf eventuele andere methoden waarvoor u functionaliteit wilt definiëren.

  6. Voeg de benodigde installatieprogramma's toe voor uw servicetoepassing. Zie Instructies voor meer informatie : Installatieprogramma's toevoegen aan uw servicetoepassing.

  7. Bouw uw project door Build Solution te selecteren in het menu Build.

    Notitie

    Druk niet op F5 om uw project uit te voeren. U kunt een serviceproject niet op deze manier uitvoeren.

  8. Installeer de service. Zie Voor meer informatie: Services installeren en verwijderen.

Zie ook