.NET 11 Preview 2: novidades do runtime, bibliotecas, ASP.NET Core e mais

Como habilitar o Runtime Async

Para experimentar o Runtime Async no nível do compilador, adicione as seguintes propriedades ao arquivo de projeto:

<PropertyGroup>
  <!-- Habilita recursos em preview e o runtime async no compilador -->
  <EnablePreviewFeatures>true</EnablePreviewFeatures>
  <Features>$(Features);runtime-async=on</Features>
</PropertyGroup>

No lado do CoreCLR, o suporte já vem habilitado por padrão no .NET 11 Preview 2. Assim, você não precisa configurar nenhuma variável de ambiente para ativar o recurso.

Pilhas de chamadas mais limpas

O ganho mais visível aparece nas pilhas de chamadas observadas durante a execução. Por exemplo, considere três métodos assíncronos aninhados, em que o último imprime a pilha atual:

using System.Diagnostics;

await OuterAsync();

static async Task OuterAsync()
{
    await Task.CompletedTask;
    await MiddleAsync();
}

static async Task MiddleAsync()
{
    await Task.CompletedTask;
    await InnerAsync();
}

static async Task InnerAsync()
{
    await Task.CompletedTask;
    // Imprime a pilha de chamadas viva neste ponto
    Console.WriteLine(new StackTrace(fNeedFileInfo: true));
}

Sem o Runtime Async, esse código produz 13 frames, muitos deles ligados à infraestrutura da máquina de estados. Com o recurso ligado, a mesma pilha mostra apenas 5 frames, ou seja, a hierarquia real de chamadas.

Isso beneficia profilers, depuradores e qualquer ferramenta de diagnóstico que inspeciona a pilha em tempo de execução. Além disso, os breakpoints agora funcionam corretamente dentro desses métodos, e o depurador atravessa os await sem entrar no código gerado.

GetTypeInfo genérico no System.Text.Json

O System.Text.Json ganhou os métodos genéricos GetTypeInfo<T>() e TryGetTypeInfo<T>() em JsonSerializerOptions. Antes, era preciso chamar a versão não genérica e fazer um cast manual do resultado.

using System.Text.Json;
using System.Text.Json.Serialization.Metadata;

var options = JsonSerializerOptions.Default;

// Antes: versão não genérica com cast manual
var oldInfo = (JsonTypeInfo<Customer>)options.GetTypeInfo(typeof(Customer));

// Agora: versão genérica e fortemente tipada
JsonTypeInfo<Customer> info = options.GetTypeInfo<Customer>();

if (options.TryGetTypeInfo<Customer>(out JsonTypeInfo<Customer>? typeInfo))
{
    // Usa os metadados de serialização do tipo
    Console.WriteLine(typeInfo.Type.Name);
}

public record Customer(string Name, string Email);

Essa mudança melhora a usabilidade ao trabalhar com JsonSerializerContext. Além disso, ela ajuda em cenários de Native AOT e de serialização polimórfica, em que o acesso a metadados é frequente e a reflexão deve ser evitada.

Seleção de formato para arquivos Tar

A API de arquivos Tar agora permite escolher o formato do arquivo gerado. Para isso, o método TarFile.CreateFromDirectory recebe um parâmetro TarEntryFormat, com suporte a Pax, Ustar, GNU e V7.

using System.Formats.Tar;

// Formato GNU para compatibilidade com ferramentas Linux
TarFile.CreateFromDirectory("/source/dir", "/dest/archive.tar",
    includeBaseDirectory: true, TarEntryFormat.Gnu);

// Versão assíncrona com cancelamento
await TarFile.CreateFromDirectoryAsync("/source/dir", "/dest/archive-pax.tar",
    includeBaseDirectory: true, TarEntryFormat.Pax, CancellationToken.None);

Dessa forma, você ganha mais controle sobre a compatibilidade com ferramentas externas que esperam um formato específico.

Matrix4x4.GetDeterminant mais rápido

O método GetDeterminant da struct Matrix4x4 recebeu uma implementação vetorizada com SSE. Segundo as notas de lançamento, o tempo caiu de 3,487 ns para 2,971 ns, uma melhoria de aproximadamente 15%.

Essa otimização importa para aplicações com uso intensivo de transformações matemáticas, como engines de jogos e simulações físicas. Para outras novidades da mesma área em prévias seguintes, veja o que mudou nas bibliotecas do .NET 11 Preview 3.

Instaladores menores no Linux e macOS

Os instaladores do SDK para Linux e macOS ficaram bem menores. De acordo com a equipe, 35% do diretório do SDK era composto por arquivos duplicados, o que somava 816 arquivos e 140 MB em disco.

A solução identifica arquivos .dll e .exe repetidos pelo hash do conteúdo e os troca por links simbólicos. Com isso, no Linux x64, o tarball caiu de 230 MB para 189 MB, enquanto os pacotes DEB e RPM caíram para cerca de 122 MB.

No Windows, a deduplicação ainda está planejada para uma versão futura. Portanto, por enquanto o ganho vale apenas para Linux e macOS.

Analisadores de código e novos avisos

A regra CA1873, que aponta operações de log potencialmente caras, recebeu duas melhorias. Primeiro, ela gera menos falsos positivos, porque acessos a propriedades, GetType() e GetHashCode() deixam de disparar o aviso.

Em segundo lugar, as mensagens agora explicam o motivo do alerta, como uma invocação de método ou uma interpolação de string. Além disso, a equipe corrigiu falsos positivos nas regras CA1515, CA1034 e CA1859.

O SDK também passa a emitir o aviso NETSDK1235 quando um projeto combina PackAsTool=true com um arquivo .nuspec personalizado. Afinal, pacotes de ferramenta exigem uma estrutura específica que esses arquivos costumam violar.

Rastreamento nativo com OpenTelemetry

O ASP.NET Core agora inclui por padrão os atributos das convenções semânticas do OpenTelemetry. Antes, esses metadados exigiam a biblioteca OpenTelemetry.Instrumentation.AspNetCore.

var builder = WebApplication.CreateBuilder(args);

// Basta assinar a fonte de atividades do ASP.NET Core
builder.Services.AddOpenTelemetry()
    .WithTracing(tracing => tracing
        .AddSource("Microsoft.AspNetCore")
        .AddConsoleExporter());

var app = builder.Build();
app.MapGet("/", () => "Hello World");
app.Run();

Assim, o framework preenche atributos como http.request.method, url.path e http.response.status_code. Caso precise desligar o comportamento, use o switch Microsoft.AspNetCore.Hosting.SuppressActivityOpenTelemetryData.

TempData no Blazor

Os componentes Blazor renderizados no servidor passam a suportar TempData, recurso já conhecido no MVC e no Razor Pages. Na prática, ele facilita mensagens após o envio de formulários e o padrão POST, Redirect, GET.

O TempData funciona como um valor em cascata, registrado automaticamente ao chamar AddRazorComponents(). Além disso, a interface ITempData oferece Get, Peek e Keep, e um provedor baseado em sessão complementa o padrão baseado em cookies.

Suporte a OpenAPI 3.2.0

O .NET 11 Preview 2 adiciona suporte à especificação OpenAPI 3.2.0 por meio de uma dependência atualizada. Você pode escolher a versão explicitamente:

builder.Services.AddOpenApi(options =>
{
    // Gera o documento na versão 3.2 da especificação
    options.OpenApiVersion = Microsoft.OpenApi.OpenApiSpecVersion.OpenApi3_2;
});

Contudo, a atualização traz breaking changes, por isso exige atenção ao migrar projetos com geração automática de documentação. Se você gera o documento durante o build, vale revisar como funciona o OpenAPI do ASP.NET Core em tempo de build.

Template de Web Worker

Um novo template permite mover processamento pesado para Web Workers do navegador. Dessa forma, a interface de aplicações Blazor WebAssembly continua responsiva enquanto o cálculo roda em segundo plano.

dotnet new webworker -n MyWebWorker

Os métodos do worker usam o atributo [JSExport] e podem ser chamados pelo WebWorkerClient. Para um passo a passo completo, leia o artigo sobre Web Workers no Blazor com .NET 11.

Performance e passkeys

O parser HTTP/1.1 do Kestrel deixou de lançar exceções para requisições malformadas. Segundo as notas, isso melhora a vazão em até 20% a 40% em cenários com varreduras de portas ou clientes mal configurados.

Além disso, o middleware de log HTTP passou a reutilizar streams de buffer. Por fim, o template Blazor Web App agora nomeia automaticamente as passkeys de autenticadores conhecidos, como Windows Hello, iCloud Keychain e 1Password.

LINQ MaxBy e MinBy

O EF Core passa a traduzir os operadores MaxBy e MinBy diretamente para SQL. Assim, você elimina consultas adicionais ou processamento no lado do cliente.

// Retorna o pedido de maior valor sem carregar todos na memória
var largestOrder = await context.Orders
    .Where(order => order.CustomerId == customerId)
    .MaxByAsync(order => order.TotalAmount);

Na prática, a consulta fica mais legível e o banco faz todo o trabalho de ordenação.

Busca vetorial com DiskANN no SQL Server

O EF Core adiciona suporte a índices vetoriais DiskANN no SQL Server e à função VECTOR_SEARCH(). Essa funcionalidade interessa a aplicações que usam embeddings e busca semântica em cenários de IA.

Se esse tema faz parte do seu projeto, o artigo sobre dados vetoriais no .NET com Microsoft.Extensions.VectorData complementa bem esta leitura.

Full-text search e JSON no SQL Server

Agora você cria catálogos e índices de texto completo do SQL Server diretamente pelas migrations do EF Core. Além disso, as funções FREETEXTTABLE() e CONTAINSTABLE() passam a ter suporte.

A função JSON_CONTAINS(), introduzida no SQL Server 2025, também chega às consultas LINQ. Com isso, você filtra colunas JSON de forma mais expressiva, sem recorrer a SQL puro.

Controle Map e TypedBinding

O controle Map ganhou TypeConverters que simplificam o XAML, permitindo escrever Region="36.9628,-122.0195,0.01,0.01". Além disso, círculos, polígonos e polilinhas ganharam IsVisible, ZIndex e eventos de clique no Android, iOS e Mac Catalyst.

O TypedBinding, que evita boxing em bindings fortemente tipados, ficou cerca de 29% mais rápido. Ao mesmo tempo, ele aloca 50% menos memória por operação de binding.

Color, Font e VisualStateManager

A struct Color recebeu anotações de imutabilidade, enquanto Font virou uma readonly struct. Dessa forma, o contrato fica mais claro e a geração de código XAML melhora.

Por outro lado, VisualStateManager.GetVisualStateGroups agora retorna VisualStateGroupList em vez de IList<VisualStateGroup>. Portanto, essa breaking change pode afetar algumas implementações.

Android exige API 24 com CoreCLR

A partir do .NET 11 Preview 2, o CoreCLR no Android exige API level 24 ou superior, o que equivale ao Android 7.0 Nougat. Enquanto isso, o Mono continua suportando a API 21 ou superior.

Aplicações que precisam atender versões anteriores do Android devem avaliar essa mudança com atenção. Além disso, iOS, tvOS e Mac Catalyst ganharam suporte experimental ao CoreCLR com <UseMonoRuntime>false</UseMonoRuntime>, tema detalhado no artigo sobre a migração do .NET MAUI para o CoreCLR.