HostBuilder 类

定义

程序初始化实用工具。

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
继承
HostBuilder
实现

构造函数

HostBuilder()

初始化 HostBuilder的新实例。

属性

Properties

用于在主机生成过程中在组件之间共享状态的中心位置。

方法

Build()

运行给定的操作来初始化主机。 此方法只能调用一次。

ConfigureAppConfiguration(Action<HostBuilderContext,IConfigurationBuilder>)

设置生成过程和应用程序的其余部分的配置。 传入 Configuration 是从调用到 ConfigureHostConfiguration(Action<IConfigurationBuilder>)生成的主机配置。 这可以多次调用,结果将累加。 处理完所有调用后,Configuration 将更新结果以供将来生成步骤使用。 生成的配置也将在 Services DI 容器中使用。

ConfigureContainer<TContainerBuilder>(Action<HostBuilderContext,TContainerBuilder>)

启用配置实例化的依赖项容器。 这可以多次调用,结果将累加。

ConfigureHostConfiguration(Action<IConfigurationBuilder>)

设置生成器本身的配置。 这将用于初始化 IHostEnvironment,以便在生成过程中的后面部分使用。 这可以多次调用,结果将累加。

ConfigureServices(Action<HostBuilderContext,IServiceCollection>)

将服务添加到容器。 这可以多次调用,结果将累加。

Equals(Object)

确定指定的对象是否等于当前对象。

(继承自 Object)
GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetType()

获取当前实例的 Type

(继承自 Object)
MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
ToString()

返回一个表示当前对象的字符串。

(继承自 Object)
UseServiceProviderFactory<TContainerBuilder>(Func<HostBuilderContext,IServiceProviderFactory<TContainerBuilder>>)

重写用于创建服务提供商的工厂。

UseServiceProviderFactory<TContainerBuilder>(IServiceProviderFactory<TContainerBuilder>)

重写用于创建服务提供商的工厂。

扩展方法

UseApplicationMetadata(IHostBuilder, String)

为应用程序元数据注册配置提供程序,并将模型对象绑定到配置。

AddFakeLoggingOutputSink(IHostBuilder, Action<String>)

添加在每个日志消息上调用的操作。

Configure(IHostBuilder, Action<IHostBuilder>)

通过委托公开更改 IHostBuilder

ConfigureAppConfiguration(IHostBuilder, String, String)

添加配置值。

ConfigureAppConfiguration(IHostBuilder, ValueTuple<String,String>[])

添加配置条目。

ConfigureHostConfiguration(IHostBuilder, String, String)

添加配置值。

ConfigureHostConfiguration(IHostBuilder, ValueTuple<String,String>[])

添加配置条目。

Start(IHostBuilder)

生成并启动主机。

StartAsync(IHostBuilder, CancellationToken)

生成并启动主机。

ConfigureAppConfiguration(IHostBuilder, Action<IConfigurationBuilder>)

设置生成过程和应用程序的其余部分的配置。 这可以多次调用,结果将累加。 结果将在后续操作 Configuration 以及 Services中提供。

ConfigureContainer<TContainerBuilder>(IHostBuilder, Action<TContainerBuilder>)

启用配置实例化的依赖项容器。 这可以多次调用,结果将累加。

ConfigureDefaults(IHostBuilder, String[])

使用预配置的默认值配置现有 IHostBuilder 实例。 这将覆盖以前配置的值,并打算在进行其他配置调用之前调用。

ConfigureHostOptions(IHostBuilder, Action<HostBuilderContext,HostOptions>)

添加用于配置 IHostHostOptions 的委托。

ConfigureHostOptions(IHostBuilder, Action<HostOptions>)

添加一个委托,用于配置与此相关的 IHost 实例的 HostOptions

ConfigureLogging(IHostBuilder, Action<HostBuilderContext,ILoggingBuilder>)

添加用于配置提供的 ILoggingBuilder的委托。 这可以多次调用。

ConfigureLogging(IHostBuilder, Action<ILoggingBuilder>)

添加用于配置提供的 ILoggingBuilder的委托。 这可以多次调用。

ConfigureMetrics(IHostBuilder, Action<IMetricsBuilder>)

添加用于配置提供的 IMetricsBuilder的委托。 这可以多次调用。

ConfigureMetrics(IHostBuilder, Action<HostBuilderContext,IMetricsBuilder>)

添加用于配置提供的 IMetricsBuilder的委托。 这可以多次调用。

ConfigureServices(IHostBuilder, Action<IServiceCollection>)

将服务添加到容器。 这可以多次调用,结果将累加。

RunConsoleAsync(IHostBuilder, Action<ConsoleLifetimeOptions>, CancellationToken)

启用控制台支持、生成和启动主机,并等待 Ctrl+C 或 SIGTERM 关闭。

RunConsoleAsync(IHostBuilder, CancellationToken)

启用控制台支持、生成和启动主机,并等待 Ctrl+C 或 SIGTERM 关闭。

UseConsoleLifetime(IHostBuilder)

侦听 Ctrl+C 或 SIGTERM 并 StopApplication() 调用以启动关闭过程。 这将取消阻止 RunAsync 和 WaitForShutdownAsync 等扩展。

UseConsoleLifetime(IHostBuilder, Action<ConsoleLifetimeOptions>)

侦听 Ctrl+C 或 SIGTERM 并 StopApplication() 调用以启动关闭过程。 这将取消阻止 RunAsync 和 WaitForShutdownAsync 等扩展。

UseContentRoot(IHostBuilder, String)

指定要由主机使用的内容根目录。

UseDefaultServiceProvider(IHostBuilder, Action<ServiceProviderOptions>)

指定要成为默认 IServiceProvider

UseDefaultServiceProvider(IHostBuilder, Action<HostBuilderContext,ServiceProviderOptions>)

指定要成为默认 IServiceProvider

UseEnvironment(IHostBuilder, String)

指定要由主机使用的环境。

UseSystemd(IHostBuilder)

IHost 生存期配置为 SystemdLifetime,为应用程序启动和停止提供通知消息,并将控制台日志记录配置为系统格式。

UseWindowsService(IHostBuilder)

将主机生存期设置为 WindowsServiceLifetime,并使用应用程序名称作为默认源名称登录到事件日志。

UseWindowsService(IHostBuilder, Action<WindowsServiceLifetimeOptions>)

将主机生存期设置为 WindowsServiceLifetime,并使用应用程序名称作为默认源名称登录到事件日志。

适用于