Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
A partire da .NET 11, una configurazione aggiunta usando AddConfiguration considera una stringa vuota come valore presente. La stringa vuota esegue quindi l'override dei valori dei provider registrati in precedenza nella configurazione esterna anziché consentire a tali valori precedenti di continuare ad avere effetto.
Questa modifica continua la distinzione tra valori di configurazione vuoti e null, introdotta in .NET 10 da valori Null mantenuti nella configurazione. La gestione di null per configurazione concatenata è invariata.
Versione introdotta
.NET 11 RC 1
Comportamento precedente
ChainedConfigurationProvider.TryGet ha segnalato una stringa vuota come non trovata. Di conseguenza, un valore vuoto in una configurazione concatenata non ha sovrascritto un valore fornito da un provider precedente:
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"]}'");
Prima di .NET 11, l'output era:
Endpoint: 'https://example.com'
Quando non era presente alcun valore precedente, la lettura della chiave restituiva nulle una sezione il cui unico valore era la stringa vuota concatenata non è stata considerata esistente.
Nuovo comportamento
A partire da .NET 11, ChainedConfigurationProvider.TryGet segnala una stringa vuota come trovata. Con l'esempio precedente, il valore vuoto di inner esegue l'override del valore precedente e l'output è:
Endpoint: ''
Una sezione il cui valore è una stringa vuota viene ora considerato esistente. Binding osserva anche il valore vuoto anziché il valore di un provider precedente. Ad esempio, l'associazione di una stringa vuota su un valore numerico precedente a una proprietà integer genera InvalidOperationException, in modo coerente con un valore vuoto fornito da un provider aggiunto direttamente.
Un valore null nel wrapped IConfiguration continua a essere considerato assente, perché l'indicizzatore IConfiguration non può distinguere una chiave il cui valore è null da una chiave mancante.
Tipo di cambiamento che interrompe la compatibilità
Questa modifica è una modifica funzionale.
Motivo della modifica
Una stringa vuota è un valore di configurazione valido. Trattandolo come mancante, la configurazione concatenata non è coerente con i provider di configurazione aggiunti direttamente e ha impedito alle applicazioni di cancellare o disabilitare intenzionalmente un'impostazione eseguendo l'override con una stringa vuota. Il nuovo comportamento mantiene la distinzione del provider di configurazione tra un valore vuoto e un valore assente. Per altre informazioni, vedere dotnet/runtime#131480.
Azione consigliata
Se una stringa vuota è destinata a sovrascrivere un valore precedente, non è necessaria alcuna azione.
Se l'app si basa su una stringa vuota in una configurazione concatenata che consente al valore di un provider precedente di avere la precedenza, rimuovere tale chiave dalla configurazione concatenata o rappresentarla come mancante o null. Le applicazioni che associano valori concatenati a tipi non stringa devono anche convalidare o normalizzare valori vuoti prima dell'associazione se un valore vuoto non è valido per il tipo di destinazione. Non esiste alcuna opzione di compatibilità per ripristinare il comportamento precedente.