BackgroundService Class

Reference

Definition

Namespace:: Microsoft.Extensions.Hosting

Assembly:: Microsoft.Extensions.Hosting.Abstractions.dll

Package:: Microsoft.Extensions.Hosting.Abstractions v10.0.0-preview.1.25080.5

Source:: BackgroundService.cs

Source:: BackgroundService.cs

Source:: BackgroundService.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Base class for implementing a long running IHostedService.

public ref class BackgroundService abstract : IDisposable, Microsoft::Extensions::Hosting::IHostedService

public abstract class BackgroundService : IDisposable, Microsoft.Extensions.Hosting.IHostedService

type BackgroundService = class
    interface IHostedService
    interface IDisposable

Public MustInherit Class BackgroundService
Implements IDisposable, IHostedService

Inheritance: Object
BackgroundService

Implements: IHostedService IDisposable

Constructors

BackgroundService()

Initializes a new instance of the BackgroundService class.

Properties

ExecuteTask

Gets the Task that executes the background operation.

Methods

Dispose()	Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
ExecuteAsync(CancellationToken)	This method is called when the IHostedService starts. The implementation should return a task that represents the lifetime of the long running operation(s) being performed.
StartAsync(CancellationToken)	Triggered when the application host is ready to start the service.
StopAsync(CancellationToken)	Triggered when the application host is performing a graceful shutdown.

Extension Methods

StartAndStopAsync(IHostedService, CancellationToken)

Starts and immediately stops the service.

Applies to

产品	版本
.NET	8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Standard	2.0 (package-provided), 2.1 (package-provided)

通过