nug Createrun NuGet
Sign in

Microsoft.Extensions.Hosting.WindowsServices

10.0.7 50 download(s)
public

.NET hosting infrastructure for Windows Services.

hosting
PackageReference 
<PackageReference Include="Microsoft.Extensions.Hosting.WindowsServices" Version="10.0.7" />
.NET CLI 
dotnet add package Microsoft.Extensions.Hosting.WindowsServices --version 10.0.7
Download .nupkg View .nuspec

Dependencies

net10.0
Package Version range
Microsoft.Extensions.Hosting [10.0.7, )
Microsoft.Extensions.Logging.EventLog [10.0.7, )
System.ServiceProcess.ServiceController [10.0.7, )
net462
Package Version range
Microsoft.Extensions.Hosting [10.0.7, )
Microsoft.Extensions.Logging.EventLog [10.0.7, )
net8.0
Package Version range
Microsoft.Extensions.Hosting [10.0.7, )
Microsoft.Extensions.Logging.EventLog [10.0.7, )
System.ServiceProcess.ServiceController [10.0.7, )
net9.0
Package Version range
Microsoft.Extensions.Hosting [10.0.7, )
Microsoft.Extensions.Logging.EventLog [10.0.7, )
System.ServiceProcess.ServiceController [10.0.7, )
netstandard2.0
Package Version range
Microsoft.Extensions.Hosting [10.0.7, )
Microsoft.Extensions.Logging.EventLog [10.0.7, )
System.ServiceProcess.ServiceController [10.0.7, )
netstandard2.1
Package Version range
Microsoft.Extensions.Hosting [10.0.7, )
Microsoft.Extensions.Logging.EventLog [10.0.7, )
System.ServiceProcess.ServiceController [10.0.7, )

Readme

## About
Supports using Windows Services with the hosting infrastructure.

## Key Features
* Can configure a host to be a Windows Service.

## How to Use
From a Worker Service app created using the Visual Studio template:
```cs
IHost host = Host.CreateDefaultBuilder(args)
    .ConfigureServices(services =>
    {
        services.AddHostedService<Worker>();
    })
    // Configure as a Windows Service
    .UseWindowsService(options =>
    {
        options.ServiceName = "My Service";
    })
    .Build();

host.Run();
```

## Main Types
The main types provided by this library are:
* `Microsoft.Extensions.Hosting.WindowsServiceLifetimeHostBuilderExtensions`
* `Microsoft.Extensions.Hosting.WindowsServices.WindowsServiceLifetime`

## Additional Documentation
* [WindowsServiceLifetime](https://learn.microsoft.com/dotnet/api/microsoft.extensions.hosting.windowsservices.windowsservicelifetime)
* [WindowsServiceLifetimeHostBuilderExtensions](https://learn.microsoft.com/dotnet/api/microsoft.extensions.hosting.windowsservicelifetimehostbuilderextensions)
* [Create Windows Service using BackgroundService](https://learn.microsoft.com/dotnet/core/extensions/windows-service)
* [Host ASP.NET Core in a Windows Service](https://learn.microsoft.com/aspnet/core/host-and-deploy/windows-service?tabs=visual-studio)

## Related Packages
- `Microsoft.Extensions.Hosting`
- `System.ServiceProcess.ServiceController`

## Feedback & Contributing

<!-- How to provide feedback on this package and contribute to it -->

Microsoft.Extensions.Hosting.WindowsServices is released as open source under the [MIT license](https://licenses.nuget.org/MIT). Bug reports and contributions are welcome at [the GitHub repository](https://github.com/dotnet/runtime).

Versions

Target frameworks

net10.0 net462 net8.0 net9.0 netstandard2.0 netstandard2.1

Metadata

Published
Size
165.91 KB
Authors
Microsoft
License
MIT
Repository
https://github.com/dotnet/dotnet commit b16286c2284fecf303dbc12a0bb152476d662e44
Flags
SemVer 1
SHA512
tx5N1u5+3P3FEeP+gvxE54qNmgq03TI1lHPz+bDVAPsYUsQLGnZgwHy+hCWSPwkztmwg/cyNsO7iv6nYkcHH8g==

Release notes

https://go.microsoft.com/fwlink/?LinkID=799421