Udostępnij za pośrednictwem


Pierwszeństwo przed prefiksem zmiennej środowiskowej ASPNET

Począwszy od platformy .NET 7 i tylko w przypadku używania WebApplicationBuilder hosta, argumentów wiersza polecenia i DOTNET_-prefiksowanych zmiennych środowiskowych zastąpić ASPNET_-prefiksowane zmienne środowiskowe podczas odczytywania z domyślnych źródeł konfiguracji hosta. Te źródła służą do odczytywania zmiennych hosta, takich jak ścieżka główna zawartości i nazwa środowiska, gdy WebApplicationBuilder element jest konstruowany i służy jako podstawa konfiguracji aplikacji.

ASPNET_-prefiksowane zmienne środowiskowe mają teraz najniższy priorytet wszystkich domyślnych źródeł konfiguracji hosta dla programu WebApplicationBuilder. W przypadku innych hostów, takich jak ConfigureWebHostDefaults i WebHost.CreateDefaultBuilder, ASPNET_zmienne środowiskowe z prefiksami mają nadal najwyższy priorytet.

Wprowadzona wersja

ASP.NET Core 7.0

Poprzednie zachowanie

ASPNET_-prefiksowane zmienne środowiskowe zastępują argumenty wiersza polecenia i DOTNET_-prefiksowane zmienne środowiskowe podczas odczytywania WebApplicationBuilderdomyślnej konfiguracji hosta.

Nowe zachowanie

Argumenty wiersza polecenia i DOTNET_-prefiksowane zmienne środowiskowe zastępują ASPNET_-prefiksowane zmienne środowiskowe podczas odczytywania WebApplicationBuilderdomyślnej konfiguracji hosta.

Typ zmiany powodującej niezgodność

Jest to zmiana behawioralna.

Przyczyna wprowadzenia zmiany

Ta zmiana została wprowadzona, aby zapobiec zastąpieniu jawnych argumentów wiersza polecenia podczas odczytywania zmiennych hosta. Nowe zachowanie jest bardziej spójne z konfiguracją aplikacji, która zawsze dała argumentom wiersza polecenia najwyższy priorytet.

Jeśli używasz ASPNETCORE_-prefiksowanych zmiennych środowiskowych, aby zastąpić argumenty wiersza polecenia lub DOTNET_-prefiksowane zmienne środowiskowe, użyj czegoś o wyższym priorytcie. Może to oznaczać użycie niestandardowego WebApplicationOptionselementu , który zastępuje wszystkie domyślne źródła konfiguracji hostingu.

Dotyczy interfejsów API

Zobacz też