ASP.NET Core/Program.cs - История изменений

Dzmuh: /* Ссылки и источники */

2022-12-01T00:09:15Z

Ссылки и источники

← Предыдущая версия		Версия от 00:09, 1 декабря 2022
Строка 207:		Строка 207:
	== Ссылки и источники ==		== Ссылки и источники ==

	[[Категория:~~Категоризовать~~]]		[[Категория:Документация к ASP.NET Core]]

Dzmuh: /* Класс WebApplicationBuilder */

2022-11-28T06:55:02Z

Класс WebApplicationBuilder

Dzmuh: /* Файл Startup.cs и класс Startup */

2022-11-28T06:33:59Z

Файл Startup.cs и класс Startup

← Предыдущая версия		Версия от 06:33, 28 ноября 2022
Строка 182:		Строка 182:
	}}</ref>, используемый шаблонами ASP.NET Core 3.1 и 5.0, полностью поддерживается.		}}</ref>, используемый шаблонами ASP.NET Core 3.1 и 5.0, полностью поддерживается.
	{{Конец коробки}}		{{Конец коробки}}
	Файл <code>Startup.cs</code> — это точка входа в приложение, аналог <code>Global.asax</code> в классическом [[ASP.NET]] и он будет вызываться после выполнения файла <code>Program.cs</code> на уровне приложения<ref>{{cite web		Файл <code>Startup.cs</code> — это точка входа в приложение<ref>{{cite web
			\|url = https://metanit.com/sharp/aspnet5/2.1.php
			\|title = Класс Startup
			\|lang = ru
			\|date = 2019-10-30
			\|access-date = 2022-11-28
			\|website = METANIT
			\|archive-url = https://web.archive.org/web/20220525002721/https://metanit.com/sharp/aspnet5/2.1.php
			\|archive-date = 2022-05-25
			}}</ref>, аналог <code>Global.asax</code> в классическом [[ASP.NET]] и он будет вызываться после выполнения файла <code>Program.cs</code> на уровне приложения<ref>{{cite web
	\|url = https://habr.com/ru/company/otus/blog/542494/		\|url = https://habr.com/ru/company/otus/blog/542494/
	\|title = Что из себя представляет класс Startup и Program.cs в ASP.NET Core		\|title = Что из себя представляет класс Startup и Program.cs в ASP.NET Core

Dzmuh: /* Program.cs */

2022-11-28T06:31:56Z

Program.cs

← Предыдущая версия		Версия от 06:31, 28 ноября 2022
Строка 44:		Строка 44:
	=== Класс WebApplicationBuilder ===		=== Класс WebApplicationBuilder ===

	Для создания объекта '''WebApplication''' необходим специальный класс-строитель - <code>WebApplicationBuilder</code><ref>{{cite web		Для создания объекта '''WebApplication'''<ref>{{cite web
			\|url = https://metanit.com/sharp/aspnet6/2.1.php
			\|title = Основы в ASP.NET Core. Создание и запуск приложения. WebApplication и WebApplicationBuilder.
			\|lang = ru
			\|date = 2021-12-06
			\|access-date = 2022-11-28
			\|website = METANIT
			\|archive-url = https://web.archive.org/web/20221004092019/https://metanit.com/sharp/aspnet6/2.1.php
			\|archive-date = 2022-10-04
			}}</ref> необходим специальный класс-строитель - <code>WebApplicationBuilder</code><ref>{{cite web
	\|url = https://github.com/dotnet/aspnetcore/blob/main/src/DefaultBuilder/src/WebApplicationBuilder.cs		\|url = https://github.com/dotnet/aspnetcore/blob/main/src/DefaultBuilder/src/WebApplicationBuilder.cs
	\|title = Исходный код WebApplicationBuilder.cs		\|title = Исходный код WebApplicationBuilder.cs

Dzmuh: /* Класс WebApplication */

2022-11-28T06:19:23Z

Класс WebApplication

← Предыдущая версия		Версия от 06:19, 28 ноября 2022
Строка 105:		Строка 105:
	Класс WebApplication применяет три интерфейса:		Класс WebApplication применяет три интерфейса:

	* IHost: применяется для запуска и остановки хоста, который прослушивает входящие запросы		* '''IHost''': применяется для запуска и остановки хоста, который прослушивает входящие запросы
	* IApplicationBuilder: применяется для установки компонентов, которые участвуют в обработке запроса		* '''IApplicationBuilder''': применяется для установки компонентов, которые участвуют в обработке запроса
	* IEndpointRouteBuilder: применяется для установки маршрутов, которые сопоставляются с запросами		* '''IEndpointRouteBuilder''': применяется для установки маршрутов, которые сопоставляются с запросами

	Для получения доступа к функциональности приложения можно использовать свойства класса WebApplication:		Для получения доступа к функциональности приложения можно использовать свойства класса WebApplication:

	* Configuration: представляет конфигурацию приложения в виде объекта IConfiguration		* '''Configuration''': представляет конфигурацию приложения в виде объекта IConfiguration
	* Environment: представляет окружение приложения в виде IWebHostEnvironment		* '''Environment''': представляет окружение приложения в виде IWebHostEnvironment
	* Lifetime: позволяет получать уведомления о событиях жизненного цикла приложения		* '''Lifetime''': позволяет получать уведомления о событиях жизненного цикла приложения
	* Logger: представляет логгер приложения по умолчанию		* '''Logger''': представляет логгер приложения по умолчанию
	* Services: представляет сервисы приложения		* '''Services''': представляет сервисы приложения
	* Urls: представляет набор адресов, которые использует сервер		* '''Urls''': представляет набор адресов, которые использует сервер

	Для управления хостом класс WebApplication определяет следующие методы:		Для управления хостом класс WebApplication определяет следующие методы:

	* Run(): запускает приложение		* '''Run()''': запускает приложение
	* RunAsync(): асинхронно запускает приложение		* '''RunAsync()''': асинхронно запускает приложение
	* Start(): запускает приложение		* '''Start()''': запускает приложение
	* StartAsync(): запускает приложение		* '''StartAsync()''': запускает приложение
	* StopAsync(): останавливает приложение		* '''StopAsync()''': останавливает приложение

	Таким образом, после вызова метод Run/Start/RunAsync/StartAsync приложение будет запущено, и мы сможем к нему обращаться:		Таким образом, после вызова метод Run/Start/RunAsync/StartAsync приложение будет запущено, и мы сможем к нему обращаться:
Строка 132:		Строка 132:
	WebApplication app = builder.Build();		WebApplication app = builder.Build();
	app.Run();		app.Run();
			</syntaxhighlight>

			При необходимости с помощью метода StopAsync() можно программным способом завершить выполнение приложения:

			<syntaxhighlight lang="csharp">
			WebApplicationBuilder builder = WebApplication.CreateBuilder();

			WebApplication app = builder.Build();

			app.MapGet("/", () => "Hello World!");

			await app.StartAsync();
			await Task.Delay(10000);
			await app.StopAsync(); // через 10 секунд завершаем выполнение приложения
	</syntaxhighlight>		</syntaxhighlight>

Dzmuh: /* Класс WebApplication */

2022-11-28T06:17:28Z

Класс WebApplication

@@ Строка 88: / Строка 88: @@
 === Класс WebApplication ===
-Метод '''build()''' класса <code>WebApplicationBuilder</code> создает объект '''WebApplication''':
+Метод '''build()''' класса <code>WebApplicationBuilder</code> создает объект '''WebApplication'''<ref>{{cite web
 <syntaxhighlight lang="csharp">
 WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
 WebApplication app = builder.Build();
 </syntaxhighlight>

Dzmuh: /* Класс WebApplicationBuilder */

2022-11-28T06:13:19Z

Класс WebApplicationBuilder

← Предыдущая версия		Версия от 06:13, 28 ноября 2022
Строка 44:		Строка 44:
	=== Класс WebApplicationBuilder ===		=== Класс WebApplicationBuilder ===

	Для создания объекта '''WebApplication''' необходим специальный класс-строитель - <code>WebApplicationBuilder</code>. В файле <code>Program.cs</code> вначале создается данный объект с помощью статического метода <code>WebApplication.CreateBuilder</code>, так:		Для создания объекта '''WebApplication''' необходим специальный класс-строитель - <code>WebApplicationBuilder</code><ref>{{cite web
			\|url = https://github.com/dotnet/aspnetcore/blob/main/src/DefaultBuilder/src/WebApplicationBuilder.cs
			\|title = Исходный код WebApplicationBuilder.cs
			\|lang = en
			\|access-date = 2022-11-28
			\|website = [[GitHub]]
			}}</ref>. В файле <code>Program.cs</code> вначале создается данный объект с помощью статического метода <code>WebApplication.CreateBuilder</code>, так:

	<syntaxhighlight lang="csharp">		<syntaxhighlight lang="csharp">
Строка 79:		Строка 85:
	* Services: представляет коллекцию сервисов и позволяет добавлять сервисы в приложение.		* Services: представляет коллекцию сервисов и позволяет добавлять сервисы в приложение.
	* WebHost: объект IWebHostBuilder, который позволяет настроить отдельные настройки сервера.		* WebHost: объект IWebHostBuilder, который позволяет настроить отдельные настройки сервера.

			=== Класс WebApplication ===

			Метод '''build()''' класса <code>WebApplicationBuilder</code> создает объект '''WebApplication''':

			<syntaxhighlight lang="csharp">
			WebApplicationBuilder builder = WebApplication.CreateBuilder(args);
			WebApplication app = builder.Build();
			</syntaxhighlight>

	== Файл <code>Startup.cs</code> и класс <code>Startup</code> ==		== Файл <code>Startup.cs</code> и класс <code>Startup</code> ==

Dzmuh: /* Program.cs */

2022-11-28T06:07:52Z

Program.cs

@@ Строка 39: / Строка 39: @@
 </syntaxhighlight>
 |}
 == Файл <code>Startup.cs</code> и класс <code>Startup</code> ==

Dzmuh: /* Program.cs */

2022-11-28T05:57:06Z

Program.cs

@@ Строка 7: / Строка 7: @@
 До ASP.NET Core 6, в котором была применена новая модель минимального размещения, файл <code>Program.cs</code> отвечает за регистрацию и заполнение <code>Startup.cs</code>.
 {{Конец коробки}}
 == Файл <code>Startup.cs</code> и класс <code>Startup</code> ==

Dzmuh: /* Файл Startup.cs и класс Startup */

2022-11-28T02:04:50Z

Файл Startup.cs и класс Startup

← Предыдущая версия		Версия от 02:04, 28 ноября 2022
Строка 33:		Строка 33:
	}}</ref>, используемый шаблонами ASP.NET Core 3.1 и 5.0, полностью поддерживается.		}}</ref>, используемый шаблонами ASP.NET Core 3.1 и 5.0, полностью поддерживается.
	{{Конец коробки}}		{{Конец коробки}}
	Файл <code>Startup.cs</code> — это точка входа, аналог <code>Global.asax</code> в классическом [[ASP.NET]] и он будет вызываться после выполнения файла <code>Program.cs</code> на уровне приложения<ref>{{cite web		Файл <code>Startup.cs</code> — это точка входа в приложение, аналог <code>Global.asax</code> в классическом [[ASP.NET]] и он будет вызываться после выполнения файла <code>Program.cs</code> на уровне приложения<ref>{{cite web
	\|url = https://habr.com/ru/company/otus/blog/542494/		\|url = https://habr.com/ru/company/otus/blog/542494/
	\|title = Что из себя представляет класс Startup и Program.cs в ASP.NET Core		\|title = Что из себя представляет класс Startup и Program.cs в ASP.NET Core
Строка 42:		Строка 42:
	\|archive-url = https://web.archive.org/web/20220922093607/https://habr.com/ru/company/otus/blog/542494/		\|archive-url = https://web.archive.org/web/20220922093607/https://habr.com/ru/company/otus/blog/542494/
	\|archive-date = 2022-09-22		\|archive-date = 2022-09-22
	}}</ref>. Он обрабатывает конвейер запросов. Класс <code>Startup</code> запускается в момент запуска приложения.		}}</ref>. Этот класс производит конфигурацию приложения, настраивает сервисы, которые приложение будет использовать, устанавливает компоненты для обработки запроса или middleware и обрабатывает конвейер запросов. Класс <code>Startup</code> запускается в момент запуска приложения.

	== Примечания ==		== Примечания ==

← Предыдущая версия		Версия от 06:55, 28 ноября 2022
Строка 78:		Строка 78:
	</syntaxhighlight>		</syntaxhighlight>

	Кроме создания объекта WebApplication класс WebApplicationBuilder выполняет еще ряд задач, среди которых можно выделить следующие:		Кроме создания объекта <code>WebApplication</code> класс <code>WebApplicationBuilder</code> выполняет еще ряд задач, среди которых можно выделить следующие:

	* Установка конфигурации приложения		* Установка конфигурации приложения
Строка 84:		Строка 84:
	* Настройка логгирования в приложении		* Настройка логгирования в приложении
	* Установка окружения приложения		* Установка окружения приложения
	* Конфигурация объектов IHostBuilder и IWebHostBuilder, которые применяются для создания хоста приложения		* Конфигурация объектов <code>IHostBuilder</code> и <code>IWebHostBuilder</code>, которые применяются для создания хоста приложения

	Для реализации этих задач в классе WebApplicationBuilder определены следующие свойства:		Для реализации этих задач в классе <code>WebApplicationBuilder</code> определены следующие свойства:

	* Configuration: представляет объект ConfigurationManager, который применяется для добавления конфигурации к приложению.		* '''Configuration''': представляет объект <code>ConfigurationManager</code>, который применяется для добавления конфигурации к приложению.
	* Environment: предоставляет информацию об окружении, в котором запущено приложение.		* '''Environment''': предоставляет информацию об окружении, в котором запущено приложение.
	* Host: объект IHostBuilder, который применяется для настройки хоста.		* '''Host''': объект <code>IHostBuilder</code>, который применяется для настройки хоста.
	* Logging: позволяет определить настройки логгирования в приложении.		* '''Logging''': позволяет определить настройки логгирования в приложении.
	* Services: представляет коллекцию сервисов и позволяет добавлять сервисы в приложение.		* '''Services''': представляет коллекцию сервисов и позволяет добавлять сервисы в приложение.
	* WebHost: объект IWebHostBuilder, который позволяет настроить отдельные настройки сервера.		* '''WebHost''': объект <code>IWebHostBuilder</code>, который позволяет настроить отдельные настройки сервера.

	=== Класс WebApplication ===		=== Класс WebApplication ===