How to: Create Windows Services in C#
When you create a service, you can use a Visual Studio project template called
Windows Service.
This template automatically does much of the work for you by
referencing the appropriate classes and namespaces, setting up the
inheritance from the base class for services, and overriding several of
the methods you're likely to want to override.
Note |
The Windows Service template and associated functionality is not available in the Standard Edition of Visual Studio. For more information, see Visual Studio Editions.
|
At a minimum, to create a functional service you must:
- Set the ServiceName property.
- Create the necessary installers for your service application.
- Override and specify code for the OnStart and OnStop methods to customize the ways in which your service behaves.
After
you add installers to your application, the next step is to create a
setup project that will install the compiled project files and run the
installers needed to install your service. To create a complete setup
project, you must add the service project's output to the setup project
and then add a custom action to have your service installed. For more
information on setup projects, see
Setup Projects. For more information on custom actions, see
Walkthrough: Creating a Custom Action.
To create a Windows Service application
- Create a Windows Service project.
- In the Properties window, set the ServiceName property for your service.
Note |
The value of the ServiceName property must always match the name recorded in the installer classes. If you change this property, you must update the ServiceName property of installer classes as well.
|
- Set any of the following properties to determine how your service will function.
Property
|
Setting
|
CanStop
| True to indicate that the service will accept requests to stop running; false to prevent the service from being stopped.
|
CanShutdown
| True
to indicate that the service wants to receive notification when the
computer on which it lives shuts down, enabling it to call the OnShutdown procedure.
|
CanPauseAndContinue
| True to indicate that the service will accept requests to pause or to resume running; false to prevent the service from being paused and resumed.
|
CanHandlePowerEvent
| True to indicate that the service can handle notification of changes to the computer's power status; false to prevent the service from being notified of these changes.
|
AutoLog
| True to write informational entries to the Application event log when your service performs an action; false to disable this functionality. For more information, see How to: Log Information About Services.
Note |
By default, AutoLog is set to true.
|
|
Note |
When CanStop or CanPauseAndContinue are set to false, the Service Control Manager will disable the corresponding menu options to stop, pause, or continue the service.
|
- Access the Code Editor and fill in the processing you want for the OnStart and OnStop procedures.
- Override any other methods for which you want to define functionality.
- Add the necessary installers for your service application. For more information,
- Build your project by selecting Build Solution from the Build menu.
Note |
Do not press F5 to run your project — you cannot run a service project in this way.
|
- Install the service. For more information, see How to: Install and Uninstall Services.
0 comments:
Post a Comment