Partager via


Propriétés obsolètes sur ConsoleLoggerOptions

Le type Microsoft.Extensions.Logging.Console.ConsoleLoggerFormat et certaines propriétés sur ConsoleLoggerOptions sont désormais obsolètes.

Description de la modification

À compter de .NET 5, le type Microsoft.Extensions.Logging.Console.ConsoleLoggerFormat et plusieurs propriétés sur ConsoleLoggerOptions sont obsolètes. Les propriétés obsolètes sont les suivantes :

Avec l’introduction de nouveaux formateurs, ces propriétés sont désormais disponibles sur les formateurs individuels.

Raison du changement

La propriété Format est un type d’énumération, qui ne peut pas représenter un formateur personnalisé.

Les propriétés restantes ont été définies sur ConsoleLoggerOptions et appliquées aux deux formats intégrés pour les journaux de console. Toutefois, avec l’introduction d’une nouvelle API de formateur, il est plus logique que la mise en forme soit représentée sur les options spécifiques au formateur. Cette modification offre une meilleure séparation entre l’enregistreur d’événements et les formateurs de l’enregistreur d’événements.

Version introduite

5,0

Les deux extraits de code JSON suivants montrent comment le fichier de configuration change. Ancien fichier de configuration :

{
  "Logging": {
    "LogLevel": {
      "Default": "None",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    },

    "Console": {
      "LogLevel": {
        "Default": "Information"
      },
      "Format": "Systemd",
      "IncludeScopes": true,
      "TimestampFormat": "HH:mm:ss",
      "UseUtcTimestamp": true
    }
  },
  "AllowedHosts": "*"
}

Nouveau fichier de configuration :

{
  "Logging": {
    "LogLevel": {
      "Default": "None",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    },

    "Console": {
      "LogLevel": {
        "Default": "Information"
      },
      "FormatterName": "Systemd",
      "FormatterOptions": {
        "IncludeScopes": true,
        "TimestampFormat": "HH:mm:ss",
        "UseUtcTimestamp": true
      }
    }
  },
  "AllowedHosts": "*"
}

API affectées