HostBuilder 类

定义

命名空间:

Microsoft.Extensions.Hosting

程序集:

Microsoft.Extensions.Hosting.dll

包:

Microsoft.Extensions.Hosting v11.0.0-preview.5.26302.115

Source:

HostBuilder.cs

程序初始化实用工具。

public ref class HostBuilder : Microsoft::Extensions::Hosting::IHostBuilder

public class HostBuilder : Microsoft.Extensions.Hosting.IHostBuilder

type HostBuilder = class
    interface IHostBuilder

Public Class HostBuilder
Implements IHostBuilder

继承

Object

HostBuilder

实现

IHostBuilder

构造函数

名称	说明
HostBuilder()	初始化 的新 HostBuilder实例。

属性

名称	说明
Properties	获取用于在主机生成过程中在组件之间共享状态的中心位置。

方法

名称	说明
Build()	运行给定的操作以初始化主机。 这只能调用一次。
ConfigureAppConfiguration(Action<HostBuilderContext,IConfigurationBuilder>)	设置生成过程和应用程序的其余部分的配置。 这可以多次调用，结果将累加。 结果将在后续操作以及 中Configuration提供Services。
ConfigureContainer<TContainerBuilder>(Action<HostBuilderContext,TContainerBuilder>)	启用配置实例化的依赖项容器。 这可以多次调用，结果将累加。
ConfigureHostConfiguration(Action<IConfigurationBuilder>)	设置生成器本身的配置。 这将用于初始化 IHostEnvironment 生成过程后面的用法。 这可以多次调用，结果将累加。
ConfigureServices(Action<HostBuilderContext,IServiceCollection>)	将服务添加到容器。 这可以多次调用，结果将累加。
UseServiceProviderFactory<TContainerBuilder>(Func<HostBuilderContext,IServiceProviderFactory<TContainerBuilder>>)	重写用于创建服务提供商的工厂。
UseServiceProviderFactory<TContainerBuilder>(IServiceProviderFactory<TContainerBuilder>)	重写用于创建服务提供商的工厂。

扩展方法

名称	说明
AddFakeLoggingOutputSink(IHostBuilder, Action<String>)	添加在每个日志消息上调用的操作。
Configure(IHostBuilder, Action<IHostBuilder>)	IHostBuilder通过委托公开更改。
ConfigureAppConfiguration(IHostBuilder, Action<IConfigurationBuilder>)	设置生成过程和应用程序的其余部分的配置。 这可以多次调用，结果将累加。 结果将在后续操作以及 中Configuration提供Services。
ConfigureAppConfiguration(IHostBuilder, String, String)	添加配置值。
ConfigureAppConfiguration(IHostBuilder, ValueTuple<String,String>[])	添加配置条目。
ConfigureContainer<TContainerBuilder>(IHostBuilder, Action<TContainerBuilder>)	启用配置实例化的依赖项容器。 这可以多次调用，结果将累加。
ConfigureDefaults(IHostBuilder, String[])	使用预配置的默认值配置现有 IHostBuilder 实例。 这将覆盖以前配置的值，并打算在进行其他配置调用之前调用。
ConfigureHostConfiguration(IHostBuilder, String, String)	添加配置值。
ConfigureHostConfiguration(IHostBuilder, ValueTuple<String,String>[])	添加配置条目。
ConfigureHostOptions(IHostBuilder, Action<HostBuilderContext,HostOptions>)	添加用于配置 的 委托。
ConfigureHostOptions(IHostBuilder, Action<HostOptions>)	添加用于配置 的 委托。
ConfigureLogging(IHostBuilder, Action<HostBuilderContext,ILoggingBuilder>)	添加用于配置提供的 ILoggingBuilder委托。 这可以多次调用。
ConfigureLogging(IHostBuilder, Action<ILoggingBuilder>)	添加用于配置提供的 ILoggingBuilder委托。 这可以多次调用。
ConfigureMetrics(IHostBuilder, Action<HostBuilderContext,IMetricsBuilder>)	添加用于配置提供的 IMetricsBuilder委托。 这可以多次调用。
ConfigureMetrics(IHostBuilder, Action<IMetricsBuilder>)	添加用于配置提供的 IMetricsBuilder委托。 这可以多次调用。
ConfigureServices(IHostBuilder, Action<IServiceCollection>)	将服务添加到容器。 这可以多次调用，结果将累加。
RunConsoleAsync(IHostBuilder, Action<ConsoleLifetimeOptions>, CancellationToken)	启用控制台支持、生成和启动主机，并等待 Ctrl+C 或 SIGTERM 关闭。
RunConsoleAsync(IHostBuilder, CancellationToken)	启用控制台支持、生成和启动主机，并等待 Ctrl+C 或 SIGTERM 关闭。
Start(IHostBuilder)	生成并启动主机。
StartAsync(IHostBuilder, CancellationToken)	生成并启动主机。
UseApplicationMetadata(IHostBuilder, String)	为应用程序元数据注册配置提供程序，并将模型对象绑定到配置。
UseConsoleLifetime(IHostBuilder, Action<ConsoleLifetimeOptions>)	侦听 Ctrl+C 或 SIGTERM 并调用 StopApplication() 以启动关闭过程。 这将取消阻止 RunAsync 和 WaitForShutdownAsync 等扩展。
UseConsoleLifetime(IHostBuilder)	侦听 Ctrl+C 或 SIGTERM 并调用 StopApplication() 以启动关闭过程。 这将取消阻止 RunAsync 和 WaitForShutdownAsync 等扩展。
UseContentRoot(IHostBuilder, String)	指定要由主机使用的内容根目录。 为了避免内容根目录被默认值覆盖，请确保在配置默认值后调用此目录。
UseDefaultServiceProvider(IHostBuilder, Action<HostBuilderContext,ServiceProviderOptions>)	指定 IServiceProvider 为默认默认值。
UseDefaultServiceProvider(IHostBuilder, Action<ServiceProviderOptions>)	指定 IServiceProvider 为默认默认值。
UseEnvironment(IHostBuilder, String)	指定要由主机使用的环境。 为了避免被默认值覆盖环境，请确保在配置默认值后调用此设置。
UseSystemd(IHostBuilder)	配置 IHost 生存期， SystemdLifetime为应用程序启动和停止提供通知消息，并在作为系统服务运行时将控制台日志记录配置为系统格式。
UseWindowsService(IHostBuilder, Action<WindowsServiceLifetimeOptions>)	将主机生存期设置为 WindowsServiceLifetime ，并使日志记录到事件日志时，应用程序名称为默认源名称。
UseWindowsService(IHostBuilder)	将主机生存期设置为 WindowsServiceLifetime ，并使日志记录到事件日志时，应用程序名称为默认源名称。