configProperties en .runtimeconfig.dev.json invalidar .runtimeconfig.json

Si una aplicación define la misma clave en tiempo de ejecución configProperties en .runtimeconfig.json y .runtimeconfig.dev.json, el .runtimeconfig.dev.json valor tiene prioridad.

Versión introducida

.NET 11 Preview 6

Comportamiento anterior

Anteriormente, .runtimeconfig.json tenía prioridad sobre .runtimeconfig.dev.json en el caso de las claves configProperties duplicadas.

Por ejemplo:

// app.runtimeconfig.json
{
  "runtimeOptions": {
    "configProperties": {
      "System.GC.Concurrent": true
    }
  }
}

// app.runtimeconfig.dev.json
{
  "runtimeOptions": {
    "configProperties": {
      "System.GC.Concurrent": false
    }
  }
}

Con esta configuración, el entorno de ejecución usó System.GC.Concurrent: true.

Nuevo comportamiento

Para admitir las anulaciones en tiempo de desarrollo en .NET 11, .runtimeconfig.dev.json tiene prioridad sobre .runtimeconfig.json en caso de claves configProperties duplicadas.

Con el mismo ejemplo, el entorno de ejecución ahora usa System.GC.Concurrent: false.

Tipo de cambio disruptivo

Este es un cambio de comportamiento.

Motivo del cambio

Este cambio permite a los desarrolladores invalidar la configuración de producción durante el desarrollo sin modificar los archivos de configuración de producción.

Para obtener más información, vea dotnet/runtime#126606.

Acción recomendada

Para garantizar un comportamiento predecible en producción, coloque las anulaciones en tiempo de desarrollo únicamente en .runtimeconfig.dev.json.

Para evitar una anulación en tiempo de desarrollo, elimine la clave duplicada de .runtimeconfig.dev.json.

Las APIs afectadas

Ninguno.

Consulte también

• Opciones de configuración de entornos de ejecución de .NET