.N @netdeveloperdiary
Showing posts older than #1290 · Back to latest
dotnet tool install -g upgrade-assistantАнализ
upgrade-assistant analyzeвам будут предоставлены инструкции по тому, как будет выглядеть обновление.
await foreach (int result in GetAsyncRange())
{
Console.WriteLine(result);
if (result >= 8)
break;
}
IAsyncEnumerable<T>, может получать маркер отмены, который должен быть помечен атрибутом EnumeratorCancellation. После этого маркер можно использовать естественным образом:async IAsyncEnumerable<int> GetAsyncRange(
[EnumeratorCancellation] CancellationToken ct = default)
{
for (int i = 0; i < 10; i++)
{
await Task.Delay(100, ct);
yield return i;
}
}
using var cts = new CancellationTokenSource(500);
CancellationToken token = cts.Token;
await foreach (int result in GetAsyncRange(token)) {
Console.WriteLine(result);
}
CancellationToken передается непосредственно методу, возвращающему асинхронный перечислитель. Это самый распространенный вариант использования.async Task ConsumeSequence(IAsyncEnumerable<int> items)
{
using var cts = new CancellationTokenSource(500);
CancellationToken ct = cts.Token;
await foreach (int item
in items.WithCancellation(ct))
{
Console.WriteLine(item);
}
}
await ConsumeSequence(GetAsyncRange());
GetAsyncRange() вызывается без токена отмены. При наличии атрибута EnumeratorCancellation компилятор автоматически обеспечит передачу маркера из WithCancellation параметру метода GetAsyncRange, помеченному атрибутом EnumeratorCancellation.TaskCanceledException, которое нужно обработать в клиентском коде.WithCancellation не препятствует ConfigureAwait(false). Оба метода расширения могут быть объединены в цепочку:items.WithCancellation(ct).ConfigureAwait(false)) …
WebApplication.CreateBuilder(). Во всех предыдущих версиях ASP.NET Core конфигурация разделена на 2 файла: Program.cs и Startup.cs (см. рисунок ниже). В .NET 6 добавлено множество изменений в C#, BCL и ASP.NET Core, и теперь всё может быть в одном файле.var builder = WebApplication.CreateBuilder(args);WebApplicationBuilder
builder.Services.AddRazorPages();
var app = builder.Build();
app.UseStaticFiles();
app.MapGet("/", () => "Hello World!");
app.MapRazorPages();
app.Run();
WebApplicationBuilder.var builder = WebApplication.CreateBuilder(args);Он отвечает за 4 основные вещи:
builder.Services.AddRazorPages();
builder.Configuration. Он предоставляет тип ConfigurationManager для добавления новых источников конфигурации, а также для доступа к значениям конфигурации, как я описал в предыдущем посте.builder.Services. Предоставляет доступ к IServiceCollection напрямую для добавления сервисов в контейнер DI.builder.Logging. Вы можете использовать, Например:builder.Logging.AddFile();4. Общая конфигурация
IHostBuilder и IWebHostBuilder. Для тех точек расширения, которые напрямую зависят от IHostBuilder или IWebHostBuilder, WebApplicationBuilder предоставляет свойства Host и WebHost соответственно. Например, настройка Serilog для ASP.NET Core подключается к IHostBuilder. С помощью WebApplicationBuilder вы можете вызвать UseSerilog() на свойстве Host:builder.Host.UseSerilog();Фактически,
WebApplicationBuilder – это то место, где вы выполняете всю настройку, кроме конвейера промежуточного ПО.WebApplicationBuilder, вы вызываете Build() для создания экземпляра WebApplication:var app = builder.Build();
WebApplication реализует несколько различных интерфейсов:IHost – для запуска и остановки хоста.IApplicationBuilder – для создания конвейера промежуточного ПО.IEndpointRouteBuilder – для добавления конечных точек.IEndpointRouteBuilder используется для добавления конечных точек путем вызова UseEndpoints() и передачи ему лямбды, например:public void Configure(IApplicationBuilder app)
{
app.UseStaticFiles();
app.UseRouting();
app.UseEndpoints(endpoints =>
{
endpoints.MapRazorPages();
});
}
WebApplication значительно упрощает этот шаблон:app.UseStaticFiles();Это явно намного проще, хотя немного обманчиво, поскольку различие между промежуточным ПО и конечными точками гораздо менее очевидно, чем в .NET 5.x. Вероятно, это просто дело вкуса, но такой подход несколько размывает концепцию важности порядка настройки (которая относится к промежуточному ПО, но не к конечным точкам).
app.MapRazorPages();
1–15 дней - ДниХотя бизнесу нравится рассматривать оценки как обязательства, помните, что оценка — это всего лишь предположение, поэтому никаких обязательств не подразумевается.
3–6 недель - Недели
8–20 недель - Месяцы
20+ недель - Хорошо подумайте, перед тем, как оценивать
ConfigurationManager был добавлен для поддержки новой модели WebApplication в ASP.NET. Однако он во многом является деталью реализации.IConfigurationBuilder - для добавления источников конфигурации. Вызов Build() считывает каждый из источников конфигурации и строит окончательную конфигурацию.IConfigurationRoot - представляет собой окончательную «построенную» конфигурацию.AddJsonFile() и AddAzureKeyVault()), которые добавляют источник конфигурации в список источников. IConfigurationRoot в свою очередь объединяет все значения из каждого источника конфигурации, чтобы дать окончательное представление всех значений.IConfigurationBuilder.Build()
- Получить необходимые значения конфигурации из построенного IConfigurationRoot
- Использовать эти значения, чтобы добавить оставшиеся источники конфигурацииIConfigurationBuilder.Build(), генерируя окончательный IConfigurationRoot и используя его для окончательной конфигурации приложения.ConfigurationManager. Он реализует как IConfigurationBuilder, так и IConfigurationRoot, позволяя оптимизировать сценарий, описанный выше.ConfigurationManager, когда добавляется IConfigurationSource (например, когда вы вызываете AddJsonFile()), поставщик сразу загружается, и конфигурация обновляется. Это позволяет избежать загрузки источников конфигурации более одного раза в сценарии частичной сборки.ConfigurationManager оптимизирован для наиболее распространённого сценария – только добавление источников. Если какой-либо из источников изменится, ConfigurationManager должен удалить всё и начать заново, перебирая каждый из источников и перезагружая их.ConfigurationManager или ConfigurationBuilder? Скорее нет.WebApplicationBuilder, представленный в .NET 6, использует ConfigurationManager, оптимизированный для описанного выше случая, когда вам необходимо частично построить конфигурацию.WebHostBuilder или HostBuilder, представленные в более ранних версиях ASP.NET, по-прежнему поддерживаются в .NET 6, и они по-прежнему «за кулисами» используют типы ConfigurationBuilder и ConfigurationRoot.async IAsyncEnumerable<int> GetAsyncRange()
{
for (int i = 0; i < 10; i++)
{
await Task.Delay(100);
yield return i;
}
}
IAsyncEnumerable<T> включает поддержку LINQ в NuGet-пакете System.Linq.Async. Заметьте, что при этом в коде нужно использовать using static System.Linq.AsyncEnumerable;Операторы LINQ можно применять к асинхронным потокам. Доступны все знакомые операторы:
Where, Select, SelectMany, Join и т.д. Результат представляет собой асинхронный поток:IAsyncEnumerable<int> values =Но что, если нам нужно передать в
GetAsyncRange().Where(value => value % 2 == 0);
await foreach (int result in values) {
Console.WriteLine(result);
}
Where асинхронный предикат? Where их не поддерживает. Но есть подходящий оператор WhereAwait:IAsyncEnumerable<int> values =Методы LINQ для асинхронных потоков можно использовать и для обычных перечисляемых объектов, вызвав
GetAsyncRange().WhereAwait(
async value => {
// Асинхронная работа для определения,
// должен ли элемент быть включён в результат
await Task.Delay(10);
return value % 2 == 0;
});
ToAsyncEnumerable() для любого IEnumerable<T>. Результат можно использовать с WhereAwait, SelectAwait и другими операторами, принимающими асинхронные делегаты.Async и Await. Операторы, заканчивающиеся суффиксом Async, возвращают обычное значение, допускающее ожидание. Операторы с суффиксом Await получают асинхронный делегат. Т.е. Await в имени подразумевает, что они используют await внутри переданного делегата.WhereAwait был приведёт выше.Async применяется только к операторам терминации (termination operators), которые извлекают некоторое значение или выполняют некоторые вычисления и возвращают асинхронное скалярное значение. Пример такого оператора — CountAsync, версия Count для асинхронного потока, которая может подсчитать количество элементов, соответствующих некоторому предикату:int count = await GetAsyncRange()Предикат может также быть асинхронным. В этом случае используется метод
.CountAsync(value => value % 2 == 0);
CountAwaitAsync, поскольку он получает асинхронного делегата и производит одно терминальное значение:int count = await GetAsyncRange().CountAwaitAsync(Итого
async value => {
await Task.Delay(10);
return value % 2 == 0;
});
Where, Select) получают синхронные делегаты и выдают асинхронную последовательность.Await (WhereAwait, SelectAwait), и выдают асинхронную последовательность.Async (CountAsync), а также могут иметь суффикс Await, если получают асинхронный делегат (CountAwaitAsync).<text> и автозаполнение. Новый редактор также изменяет способ диагностики, чтобы гарантировать отображение только наиболее важных диагностических сообщений.
202 Accepted.202 Accepted (например, в JSON). Другой вариант - вернуть URI статуса в заголовке ответа Location.200 OK с каким-то индикатором «незавершённого статуса» в теле. Другие снова возвращают 202 Accepted. Сервер также может дополнительно включать «процент завершения» в тело ответа и/или заголовок Retry-After, если он имеет предполагаемое время завершения (для предотвращения чрезмерно частых вызовов).200 OK с «ошибкой» в теле ответа, либо вернуть соответствующий код ошибки (4xx/5xx) с дополнительными сведениями об ошибке в теле ответа. В случае успеха URI статуса может возвращать 303 See Other с заголовком Location для ресурса, который был обновлён/изменён через асинхронное сообщение. Либо вернуть 200 OK, 201 Created или 204 No Content, чтобы указать на успешное завершение.IHostedService или IHostApplicationLifetime для обнаружения и блокировки завершения работы приложения HTTP. BackgroundService также можно использовать, но имейте в виду, что работа может быть потеряна, если время завершения работы хоста истечёт.HostingEnvironment.QueueBackgroundWorkItem или IRegisteredObject.