Nguon: Microsoft Learn · .NET 8.0

Thay đổi có thể gây lỗi: IPNetwork và ForwardedHeadersOptions.KnownNetworks đã lỗi thời (obsolete)

Nguồn: IPNetwork and ForwardedHeadersOptions.KnownNetworks are obsolete

Microsoft.AspNetCore.HttpOverrides.IPNetworkKnownNetworks đã được đánh dấu là obsolete (lỗi thời) để ủng hộ việc sử dụng System.Net.IPNetworkKnownIPNetworks.

Phiên bản được giới thiệu

.NET 10 Preview 7

Hành vi trước đây

Trước đây, bạn có thể sử dụng Microsoft.AspNetCore.HttpOverrides.IPNetworkKnownNetworks để cấu hình các mạng đã biết cho forwarded headers middleware (phần mềm trung gian tiêu đề chuyển tiếp):

csharp
app.UseForwardedHeaders(new ForwardedHeadersOptions
{
    KnownNetworks.Add(new(IPAddress.Loopback, 8))
});

Hành vi mới

Bắt đầu từ .NET 10, nếu bạn sử dụng các API lỗi thời trong code của mình, bạn sẽ nhận được cảnh báo ASPDEPR005 tại compile time:

warning ASPDEPR005: Please use KnownIPNetworks instead. For more information, visit https://aka.ms/aspnet/deprecate/005.

Hãy sử dụng kiểu System.Net.IPNetwork và thuộc tính KnownIPNetworks thay thế.

Loại thay đổi có thể gây lỗi

Thay đổi này có thể ảnh hưởng đến source compatibility (tương thích mã nguồn).

Lý do thay đổi

System.Net.IPNetwork đã thay thế kiểu Microsoft.AspNetCore.HttpOverrides.IPNetwork được triển khai cho ForwardedHeadersMiddleware.

Hành động được khuyến nghị

Chuyển sang sử dụng System.Net.IPNetworkKnownIPNetworks.

Các API bị ảnh hưởng