Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Från och med .NET 11 behandlar en konfiguration som läggs till med hjälp av AddConfiguration en tom sträng som ett befintligt värde. Den tomma strängen åsidosätter därför värden från leverantörer som registrerats tidigare i den yttre konfigurationen i stället för att tillåta att de tidigare värdena fortsätter att gälla.
Den här ändringen fortsätter skillnaden mellan tomma värden och nullvärden som infördes i .NET 10 genom Null-värden som bevaras i konfigurationen. Hanteringen av null av den länkade konfigurationen är oförändrad.
Version som introducerades
.NET 11 RC 1
Tidigare beteende
ChainedConfigurationProvider.TryGet rapporterade att en tom sträng inte hittades. Ett tomt värde i en länkad konfiguration åsidosatte därför inte ett värde som angavs av en tidigare provider:
using System;
using System.Collections.Generic;
using Microsoft.Extensions.Configuration;
IConfiguration inner = new ConfigurationBuilder()
.AddInMemoryCollection(new Dictionary<string, string?>
{
["Endpoint"] = "",
})
.Build();
IConfiguration configuration = new ConfigurationBuilder()
.AddInMemoryCollection(new Dictionary<string, string?>
{
["Endpoint"] = "https://example.com",
})
.AddConfiguration(inner)
.Build();
Console.WriteLine($"Endpoint: '{configuration["Endpoint"]}'");
Före .NET 11 var utdata:
Endpoint: 'https://example.com'
När det inte fanns något tidigare värde gav läsning av nyckeln null, och ett avsnitt vars enda värde var den länkade tomma strängen ansågs inte finnas.
Nytt beteende
Från och med .NET 11 rapporterar ChainedConfigurationProvider.TryGet att en tom sträng hittades. Med föregående exempel åsidosätter det tomma värdet från inner det tidigare värdet, och utdata är:
Endpoint: ''
Ett avsnitt vars värde är en tom sträng anses nu finnas. Binding observerar också det tomma värdet i stället för värdet från en tidigare provider. Till exempel utlöser bindning av en tom sträng över ett tidigare numeriskt värde till en heltalsegenskap InvalidOperationException, i enlighet med ett tomt värde som tillhandahålls av en direkt tillagd provider.
Ett null värde i den omslutna IConfiguration fortsätter att behandlas som frånvarande, eftersom IConfiguration indexeraren inte kan skilja en nyckel vars värde är null från en nyckel som saknas.
Typ av kompatibilitetsbrytande ändring
Den här ändringen är en beteendeförändring.
Orsak till ändringen
En tom sträng är ett giltigt konfigurationsvärde. Att behandla den som saknad gjorde den länkade konfigurationen inkonsekvent med direkt tillagda konfigurationsprovidrar och hindrade program från att avsiktligt rensa eller inaktivera en inställning genom att åsidosätta den med en tom sträng. Det nya beteendet bevarar konfigurationsproviderns skillnad mellan ett tomt värde och ett frånvarande värde. För mer information, se dotnet/runtime#131480.
Rekommenderad åtgärd
Om en tom sträng är avsedd att åsidosätta ett tidigare värde krävs ingen åtgärd.
Om din app förlitade sig på en tom sträng i en länkad konfiguration där en tidigare providers värde får företräde, ska du ta bort nyckeln från den länkade konfigurationen eller representera den som saknad eller null. Program som binder samman kedjade värden till icke-strängtyper bör också verifiera eller normalisera tomma värden före bindning om ett tomt värde inte är giltigt för måltypen. Det finns ingen kompatibilitetsväxling för att återställa det tidigare beteendet.