From: Steve Harter Date: Fri, 8 Sep 2023 14:54:36 +0000 (-0500) Subject: Add Microsoft.Extensions.Hosting.Abstractions X-Git-Tag: accepted/tizen/unified/riscv/20231226.055536~97^2^2~27 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=57a8f86490f29f5fd3bd96b0f45f9f89a4803d24;p=platform%2Fupstream%2Fdotnet%2Fruntime.git Add Microsoft.Extensions.Hosting.Abstractions --- diff --git a/src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/PACKAGE.md b/src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/PACKAGE.md index b94327b..e699e51 100644 --- a/src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/PACKAGE.md +++ b/src/libraries/Microsoft.Extensions.Hosting.Abstractions/src/PACKAGE.md @@ -1,44 +1,43 @@ ## About +Contains abstractions to host user code in an application by encapsulating an application's resources and lifetime functionality including: +- Dependency injection (DI). +- Logging. +- Configuration. +- Starting, stopping and obtaining notifications. - - - +This package is also used to wire up specific application models like ASP.NET Core that are built on top of hosting. ## Key Features - - - -* -* -* +* Provides the `BackgroundService` base class and the `IHostedService` interface for implementing worker services. +* Provides interfaces used to configure and start\stop a host. +* Provides types to obtain environment settings such as an application name and paths. ## How to Use - - +See the Conceptual documentation below for using `BackgroundService` and `IHostedService` to host worker services. ## Main Types - - - The main types provided by this library are: -* `` -* `` -* `` +* `Microsoft.Extensions.Hosting.BackgroundService` +* `Microsoft.Extensions.Hosting.IHostBuilder` +* `Microsoft.Extensions.Hosting.IHostedService` ## Additional Documentation - - - -* [Conceptual documentation](https://learn.microsoft.com/en-us/dotnet/standard/serialization/**LIBRARYNAME**/overview) -* [API documentation](https://learn.microsoft.com/en-us/dotnet/api/**LIBRARYNAME**) +* [Conceptual documentation] + - [Worker services in .NET](https://learn.microsoft.com/dotnet/core/extensions/workers) + - [Implement the IHostedService interface](https://learn.microsoft.com/dotnet/core/extensions/timer-service) +* [API documentation] + - [BackgroundService](https://learn.microsoft.com/dotnet/api/microsoft.extensions.hosting.backgroundservice) + - [IHostBuilder](https://learn.microsoft.com/dotnet/api/microsoft.extensions.hosting.ihostbuilder) + - [IHostedService](https://learn.microsoft.com/dotnet/api/microsoft.extensions.hosting.ihostedservice) ## Related Packages - - +- `Microsoft.Extensions.Hosting` +- `Microsoft.Extensions.Configuration.Abstractions` +- `Microsoft.Extensions.DependencyInjection.Abstractions` +- `Microsoft.Extensions.Diagnostics.Abstractions` +- `Microsoft.Extensions.FileProviders.Abstractions` +- `Microsoft.Extensions.Logging.Abstractions` ## Feedback & Contributing - - - -Microsoft.Extensions.Hosting.Abstractions 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). \ No newline at end of file +Microsoft.Extensions.Hosting.Abstractions 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).