Microsoft.Extensions.Hosting.Abstractions.xml 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339
  1. <?xml version="1.0"?>
  2. <doc>
  3. <assembly>
  4. <name>Microsoft.Extensions.Hosting.Abstractions</name>
  5. </assembly>
  6. <members>
  7. <member name="T:Microsoft.Extensions.Hosting.BackgroundService">
  8. <summary>
  9. Base class for implementing a long running <see cref="T:Microsoft.Extensions.Hosting.IHostedService"/>.
  10. </summary>
  11. </member>
  12. <member name="M:Microsoft.Extensions.Hosting.BackgroundService.ExecuteAsync(System.Threading.CancellationToken)">
  13. <summary>
  14. This method is called when the <see cref="T:Microsoft.Extensions.Hosting.IHostedService"/> starts. The implementation should return a task that represents
  15. the lifetime of the long running operation(s) being performed.
  16. </summary>
  17. <param name="stoppingToken">Triggered when <see cref="M:Microsoft.Extensions.Hosting.IHostedService.StopAsync(System.Threading.CancellationToken)"/> is called.</param>
  18. <returns>A <see cref="T:System.Threading.Tasks.Task"/> that represents the long running operations.</returns>
  19. </member>
  20. <member name="M:Microsoft.Extensions.Hosting.BackgroundService.StartAsync(System.Threading.CancellationToken)">
  21. <summary>
  22. Triggered when the application host is ready to start the service.
  23. </summary>
  24. <param name="cancellationToken">Indicates that the start process has been aborted.</param>
  25. </member>
  26. <member name="M:Microsoft.Extensions.Hosting.BackgroundService.StopAsync(System.Threading.CancellationToken)">
  27. <summary>
  28. Triggered when the application host is performing a graceful shutdown.
  29. </summary>
  30. <param name="cancellationToken">Indicates that the shutdown process should no longer be graceful.</param>
  31. </member>
  32. <member name="T:Microsoft.Extensions.Hosting.EnvironmentName">
  33. <summary>
  34. Commonly used environment names.
  35. </summary>
  36. </member>
  37. <member name="T:Microsoft.Extensions.Hosting.HostBuilderContext">
  38. <summary>
  39. Context containing the common services on the <see cref="T:Microsoft.Extensions.Hosting.IHost" />. Some properties may be null until set by the <see cref="T:Microsoft.Extensions.Hosting.IHost" />.
  40. </summary>
  41. </member>
  42. <member name="P:Microsoft.Extensions.Hosting.HostBuilderContext.HostingEnvironment">
  43. <summary>
  44. The <see cref="T:Microsoft.Extensions.Hosting.IHostingEnvironment" /> initialized by the <see cref="T:Microsoft.Extensions.Hosting.IHost" />.
  45. </summary>
  46. </member>
  47. <member name="P:Microsoft.Extensions.Hosting.HostBuilderContext.Configuration">
  48. <summary>
  49. The <see cref="T:Microsoft.Extensions.Configuration.IConfiguration" /> containing the merged configuration of the application and the <see cref="T:Microsoft.Extensions.Hosting.IHost" />.
  50. </summary>
  51. </member>
  52. <member name="P:Microsoft.Extensions.Hosting.HostBuilderContext.Properties">
  53. <summary>
  54. A central location for sharing state between components during the host building process.
  55. </summary>
  56. </member>
  57. <member name="T:Microsoft.Extensions.Hosting.HostDefaults">
  58. <summary>
  59. Constants for HostBuilder configuration keys.
  60. </summary>
  61. </member>
  62. <member name="F:Microsoft.Extensions.Hosting.HostDefaults.ApplicationKey">
  63. <summary>
  64. The configuration key used to set <see cref="P:Microsoft.Extensions.Hosting.IHostingEnvironment.ApplicationName"/>.
  65. </summary>
  66. </member>
  67. <member name="F:Microsoft.Extensions.Hosting.HostDefaults.EnvironmentKey">
  68. <summary>
  69. The configuration key used to set <see cref="P:Microsoft.Extensions.Hosting.IHostingEnvironment.EnvironmentName"/>.
  70. </summary>
  71. </member>
  72. <member name="F:Microsoft.Extensions.Hosting.HostDefaults.ContentRootKey">
  73. <summary>
  74. The configuration key used to set <see cref="P:Microsoft.Extensions.Hosting.IHostingEnvironment.ContentRootPath"/>
  75. and <see cref="P:Microsoft.Extensions.Hosting.IHostingEnvironment.ContentRootFileProvider"/>.
  76. </summary>
  77. </member>
  78. <member name="M:Microsoft.Extensions.Hosting.HostingAbstractionsHostBuilderExtensions.Start(Microsoft.Extensions.Hosting.IHostBuilder)">
  79. <summary>
  80. Start the host and listen on the specified urls.
  81. </summary>
  82. <param name="hostBuilder">The <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder"/> to start.</param>
  83. <returns>The <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder"/>.</returns>
  84. </member>
  85. <member name="M:Microsoft.Extensions.Hosting.HostingAbstractionsHostExtensions.Start(Microsoft.Extensions.Hosting.IHost)">
  86. <summary>
  87. Starts the host synchronously.
  88. </summary>
  89. <param name="host"></param>
  90. </member>
  91. <member name="M:Microsoft.Extensions.Hosting.HostingAbstractionsHostExtensions.StopAsync(Microsoft.Extensions.Hosting.IHost,System.TimeSpan)">
  92. <summary>
  93. Attempts to gracefully stop the host with the given timeout.
  94. </summary>
  95. <param name="host"></param>
  96. <param name="timeout">The timeout for stopping gracefully. Once expired the
  97. server may terminate any remaining active connections.</param>
  98. <returns></returns>
  99. </member>
  100. <member name="M:Microsoft.Extensions.Hosting.HostingAbstractionsHostExtensions.WaitForShutdown(Microsoft.Extensions.Hosting.IHost)">
  101. <summary>
  102. Block the calling thread until shutdown is triggered via Ctrl+C or SIGTERM.
  103. </summary>
  104. <param name="host">The running <see cref="T:Microsoft.Extensions.Hosting.IHost"/>.</param>
  105. </member>
  106. <member name="M:Microsoft.Extensions.Hosting.HostingAbstractionsHostExtensions.Run(Microsoft.Extensions.Hosting.IHost)">
  107. <summary>
  108. Runs an application and block the calling thread until host shutdown.
  109. </summary>
  110. <param name="host">The <see cref="T:Microsoft.Extensions.Hosting.IHost"/> to run.</param>
  111. </member>
  112. <member name="M:Microsoft.Extensions.Hosting.HostingAbstractionsHostExtensions.RunAsync(Microsoft.Extensions.Hosting.IHost,System.Threading.CancellationToken)">
  113. <summary>
  114. Runs an application and returns a Task that only completes when the token is triggered or shutdown is triggered.
  115. </summary>
  116. <param name="host">The <see cref="T:Microsoft.Extensions.Hosting.IHost"/> to run.</param>
  117. <param name="token">The token to trigger shutdown.</param>
  118. </member>
  119. <member name="M:Microsoft.Extensions.Hosting.HostingAbstractionsHostExtensions.WaitForShutdownAsync(Microsoft.Extensions.Hosting.IHost,System.Threading.CancellationToken)">
  120. <summary>
  121. Returns a Task that completes when shutdown is triggered via the given token.
  122. </summary>
  123. <param name="host">The running <see cref="T:Microsoft.Extensions.Hosting.IHost"/>.</param>
  124. <param name="token">The token to trigger shutdown.</param>
  125. </member>
  126. <member name="T:Microsoft.Extensions.Hosting.HostingEnvironmentExtensions">
  127. <summary>
  128. Extension methods for <see cref="T:Microsoft.Extensions.Hosting.IHostingEnvironment"/>.
  129. </summary>
  130. </member>
  131. <member name="M:Microsoft.Extensions.Hosting.HostingEnvironmentExtensions.IsDevelopment(Microsoft.Extensions.Hosting.IHostingEnvironment)">
  132. <summary>
  133. Checks if the current hosting environment name is <see cref="F:Microsoft.Extensions.Hosting.EnvironmentName.Development"/>.
  134. </summary>
  135. <param name="hostingEnvironment">An instance of <see cref="T:Microsoft.Extensions.Hosting.IHostingEnvironment"/>.</param>
  136. <returns>True if the environment name is <see cref="F:Microsoft.Extensions.Hosting.EnvironmentName.Development"/>, otherwise false.</returns>
  137. </member>
  138. <member name="M:Microsoft.Extensions.Hosting.HostingEnvironmentExtensions.IsStaging(Microsoft.Extensions.Hosting.IHostingEnvironment)">
  139. <summary>
  140. Checks if the current hosting environment name is <see cref="F:Microsoft.Extensions.Hosting.EnvironmentName.Staging"/>.
  141. </summary>
  142. <param name="hostingEnvironment">An instance of <see cref="T:Microsoft.Extensions.Hosting.IHostingEnvironment"/>.</param>
  143. <returns>True if the environment name is <see cref="F:Microsoft.Extensions.Hosting.EnvironmentName.Staging"/>, otherwise false.</returns>
  144. </member>
  145. <member name="M:Microsoft.Extensions.Hosting.HostingEnvironmentExtensions.IsProduction(Microsoft.Extensions.Hosting.IHostingEnvironment)">
  146. <summary>
  147. Checks if the current hosting environment name is <see cref="F:Microsoft.Extensions.Hosting.EnvironmentName.Production"/>.
  148. </summary>
  149. <param name="hostingEnvironment">An instance of <see cref="T:Microsoft.Extensions.Hosting.IHostingEnvironment"/>.</param>
  150. <returns>True if the environment name is <see cref="F:Microsoft.Extensions.Hosting.EnvironmentName.Production"/>, otherwise false.</returns>
  151. </member>
  152. <member name="M:Microsoft.Extensions.Hosting.HostingEnvironmentExtensions.IsEnvironment(Microsoft.Extensions.Hosting.IHostingEnvironment,System.String)">
  153. <summary>
  154. Compares the current hosting environment name against the specified value.
  155. </summary>
  156. <param name="hostingEnvironment">An instance of <see cref="T:Microsoft.Extensions.Hosting.IHostingEnvironment"/>.</param>
  157. <param name="environmentName">Environment name to validate against.</param>
  158. <returns>True if the specified name is the same as the current environment, otherwise false.</returns>
  159. </member>
  160. <member name="T:Microsoft.Extensions.Hosting.IApplicationLifetime">
  161. <summary>
  162. Allows consumers to perform cleanup during a graceful shutdown.
  163. </summary>
  164. </member>
  165. <member name="P:Microsoft.Extensions.Hosting.IApplicationLifetime.ApplicationStarted">
  166. <summary>
  167. Triggered when the application host has fully started and is about to wait
  168. for a graceful shutdown.
  169. </summary>
  170. </member>
  171. <member name="P:Microsoft.Extensions.Hosting.IApplicationLifetime.ApplicationStopping">
  172. <summary>
  173. Triggered when the application host is performing a graceful shutdown.
  174. Requests may still be in flight. Shutdown will block until this event completes.
  175. </summary>
  176. </member>
  177. <member name="P:Microsoft.Extensions.Hosting.IApplicationLifetime.ApplicationStopped">
  178. <summary>
  179. Triggered when the application host is performing a graceful shutdown.
  180. All requests should be complete at this point. Shutdown will block
  181. until this event completes.
  182. </summary>
  183. </member>
  184. <member name="M:Microsoft.Extensions.Hosting.IApplicationLifetime.StopApplication">
  185. <summary>
  186. Requests termination of the current application.
  187. </summary>
  188. </member>
  189. <member name="T:Microsoft.Extensions.Hosting.IHost">
  190. <summary>
  191. A program abstraction.
  192. </summary>
  193. </member>
  194. <member name="P:Microsoft.Extensions.Hosting.IHost.Services">
  195. <summary>
  196. The programs configured services.
  197. </summary>
  198. </member>
  199. <member name="M:Microsoft.Extensions.Hosting.IHost.StartAsync(System.Threading.CancellationToken)">
  200. <summary>
  201. Start the program.
  202. </summary>
  203. <param name="cancellationToken">Used to abort program start.</param>
  204. <returns></returns>
  205. </member>
  206. <member name="M:Microsoft.Extensions.Hosting.IHost.StopAsync(System.Threading.CancellationToken)">
  207. <summary>
  208. Attempts to gracefully stop the program.
  209. </summary>
  210. <param name="cancellationToken">Used to indicate when stop should no longer be graceful.</param>
  211. <returns></returns>
  212. </member>
  213. <member name="T:Microsoft.Extensions.Hosting.IHostBuilder">
  214. <summary>
  215. A program initialization abstraction.
  216. </summary>
  217. </member>
  218. <member name="P:Microsoft.Extensions.Hosting.IHostBuilder.Properties">
  219. <summary>
  220. A central location for sharing state between components during the host building process.
  221. </summary>
  222. </member>
  223. <member name="M:Microsoft.Extensions.Hosting.IHostBuilder.ConfigureHostConfiguration(System.Action{Microsoft.Extensions.Configuration.IConfigurationBuilder})">
  224. <summary>
  225. Set up the configuration for the builder itself. This will be used to initialize the <see cref="T:Microsoft.Extensions.Hosting.IHostingEnvironment"/>
  226. for use later in the build process. This can be called multiple times and the results will be additive.
  227. </summary>
  228. <param name="configureDelegate">The delegate for configuring the <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder"/> that will be used
  229. to construct the <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> for the host.</param>
  230. <returns>The same instance of the <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder"/> for chaining.</returns>
  231. </member>
  232. <member name="M:Microsoft.Extensions.Hosting.IHostBuilder.ConfigureAppConfiguration(System.Action{Microsoft.Extensions.Hosting.HostBuilderContext,Microsoft.Extensions.Configuration.IConfigurationBuilder})">
  233. <summary>
  234. Sets up the configuration for the remainder of the build process and application. This can be called multiple times and
  235. the results will be additive. The results will be available at <see cref="P:Microsoft.Extensions.Hosting.HostBuilderContext.Configuration"/> for
  236. subsequent operations, as well as in <see cref="P:Microsoft.Extensions.Hosting.IHost.Services"/>.
  237. </summary>
  238. <param name="configureDelegate">The delegate for configuring the <see cref="T:Microsoft.Extensions.Configuration.IConfigurationBuilder"/> that will be used
  239. to construct the <see cref="T:Microsoft.Extensions.Configuration.IConfiguration"/> for the application.</param>
  240. <returns>The same instance of the <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder"/> for chaining.</returns>
  241. </member>
  242. <member name="M:Microsoft.Extensions.Hosting.IHostBuilder.ConfigureServices(System.Action{Microsoft.Extensions.Hosting.HostBuilderContext,Microsoft.Extensions.DependencyInjection.IServiceCollection})">
  243. <summary>
  244. Adds services to the container. This can be called multiple times and the results will be additive.
  245. </summary>
  246. <param name="configureDelegate">The delegate for configuring the <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> that will be used
  247. to construct the <see cref="T:System.IServiceProvider"/>.</param>
  248. <returns>The same instance of the <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder"/> for chaining.</returns>
  249. </member>
  250. <member name="M:Microsoft.Extensions.Hosting.IHostBuilder.UseServiceProviderFactory``1(Microsoft.Extensions.DependencyInjection.IServiceProviderFactory{``0})">
  251. <summary>
  252. Overrides the factory used to create the service provider.
  253. </summary>
  254. <typeparam name="TContainerBuilder"></typeparam>
  255. <param name="factory"></param>
  256. <returns>The same instance of the <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder"/> for chaining.</returns>
  257. </member>
  258. <member name="M:Microsoft.Extensions.Hosting.IHostBuilder.ConfigureContainer``1(System.Action{Microsoft.Extensions.Hosting.HostBuilderContext,``0})">
  259. <summary>
  260. Enables configuring the instantiated dependency container. This can be called multiple times and
  261. the results will be additive.
  262. </summary>
  263. <typeparam name="TContainerBuilder"></typeparam>
  264. <param name="configureDelegate"></param>
  265. <returns>The same instance of the <see cref="T:Microsoft.Extensions.Hosting.IHostBuilder"/> for chaining.</returns>
  266. </member>
  267. <member name="M:Microsoft.Extensions.Hosting.IHostBuilder.Build">
  268. <summary>
  269. Run the given actions to initialize the host. This can only be called once.
  270. </summary>
  271. <returns>An initialized <see cref="T:Microsoft.Extensions.Hosting.IHost"/></returns>
  272. </member>
  273. <member name="T:Microsoft.Extensions.Hosting.IHostedService">
  274. <summary>
  275. Defines methods for objects that are managed by the host.
  276. </summary>
  277. </member>
  278. <member name="M:Microsoft.Extensions.Hosting.IHostedService.StartAsync(System.Threading.CancellationToken)">
  279. <summary>
  280. Triggered when the application host is ready to start the service.
  281. </summary>
  282. <param name="cancellationToken">Indicates that the start process has been aborted.</param>
  283. </member>
  284. <member name="M:Microsoft.Extensions.Hosting.IHostedService.StopAsync(System.Threading.CancellationToken)">
  285. <summary>
  286. Triggered when the application host is performing a graceful shutdown.
  287. </summary>
  288. <param name="cancellationToken">Indicates that the shutdown process should no longer be graceful.</param>
  289. </member>
  290. <member name="T:Microsoft.Extensions.Hosting.IHostingEnvironment">
  291. <summary>
  292. Provides information about the hosting environment an application is running in.
  293. </summary>
  294. </member>
  295. <member name="P:Microsoft.Extensions.Hosting.IHostingEnvironment.EnvironmentName">
  296. <summary>
  297. Gets or sets the name of the environment. The host automatically sets this property to the value of the
  298. of the "environment" key as specified in configuration.
  299. </summary>
  300. </member>
  301. <member name="P:Microsoft.Extensions.Hosting.IHostingEnvironment.ApplicationName">
  302. <summary>
  303. Gets or sets the name of the application. This property is automatically set by the host to the assembly containing
  304. the application entry point.
  305. </summary>
  306. </member>
  307. <member name="P:Microsoft.Extensions.Hosting.IHostingEnvironment.ContentRootPath">
  308. <summary>
  309. Gets or sets the absolute path to the directory that contains the application content files.
  310. </summary>
  311. </member>
  312. <member name="P:Microsoft.Extensions.Hosting.IHostingEnvironment.ContentRootFileProvider">
  313. <summary>
  314. Gets or sets an <see cref="T:Microsoft.Extensions.FileProviders.IFileProvider"/> pointing at <see cref="P:Microsoft.Extensions.Hosting.IHostingEnvironment.ContentRootPath"/>.
  315. </summary>
  316. </member>
  317. <member name="M:Microsoft.Extensions.Hosting.IHostLifetime.WaitForStartAsync(System.Threading.CancellationToken)">
  318. <summary>
  319. Called at the start of <see cref="M:Microsoft.Extensions.Hosting.IHost.StartAsync(System.Threading.CancellationToken)"/> which will wait until it's complete before
  320. continuing. This can be used to delay startup until signaled by an external event.
  321. </summary>
  322. </member>
  323. <member name="M:Microsoft.Extensions.Hosting.IHostLifetime.StopAsync(System.Threading.CancellationToken)">
  324. <summary>
  325. Called from <see cref="M:Microsoft.Extensions.Hosting.IHost.StopAsync(System.Threading.CancellationToken)"/> to indicate that the host as stopped and clean up resources.
  326. </summary>
  327. <param name="cancellationToken">Used to indicate when stop should no longer be graceful.</param>
  328. <returns></returns>
  329. </member>
  330. <member name="M:Microsoft.Extensions.DependencyInjection.ServiceCollectionHostedServiceExtensions.AddHostedService``1(Microsoft.Extensions.DependencyInjection.IServiceCollection)">
  331. <summary>
  332. Add an <see cref="T:Microsoft.Extensions.Hosting.IHostedService"/> registration for the given type.
  333. </summary>
  334. <typeparam name="THostedService">An <see cref="T:Microsoft.Extensions.Hosting.IHostedService"/> to register.</typeparam>
  335. <param name="services">The <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/> to register with.</param>
  336. <returns>The original <see cref="T:Microsoft.Extensions.DependencyInjection.IServiceCollection"/>.</returns>
  337. </member>
  338. </members>
  339. </doc>