Nouveaux ID de diagnostic pour les API obsolètes

  • Article

Auparavant, certaines API ont été rendues obsolètes sans utiliser d’ID de diagnostic personnalisés. À compter de .NET 6, ces API sont obsolètes avec différents ID de diagnostic personnalisés. Si vous avez supprimé les avertissements d’utilisation de ces API via CS0618, modifiez les suppressions pour utiliser les nouveaux ID de diagnostic, qui sont SYSLIB0003, SYSLIB0019 et SYSLIB0020.

Description de la modification

Le tableau suivant montre les anciens et les nouveaux ID de diagnostic pour l’API obsolète répertoriée.

API ID de diagnostic précédent Nouvel ID de diagnostic
Thread.GetCompressedStack() CS0618 SYSLIB0003
Thread.SetCompressedStack(CompressedStack) CS0618 SYSLIB0003
RuntimeEnvironment.SystemConfigurationFile CS0618 SYSLIB0019
RuntimeEnvironment.GetRuntimeInterfaceAsIntPtr(Guid, Guid) CS0618 SYSLIB0019
RuntimeEnvironment.GetRuntimeInterfaceAsObject(Guid, Guid) CS0618 SYSLIB0019
JsonSerializerOptions.IgnoreNullValues CS0618 SYSLIB0020

Version introduite

.NET 6

Raison du changement

À compter de .NET 5, les obsolescences sont destinées à utiliser des valeurs d’ID de diagnostic personnalisées pour permettre une suppression affinée des avertissements. Cela offre une meilleure expérience lorsque les API obsolètes doivent rester référencées. Les obsolescences affectées ici devraient avoir des valeurs d’ID de diagnostic personnalisées appliquées lorsque les API étaient initialement marquées comme [Obsolete].

Si les ID de diagnostic SYSLIB0003, SYSLIB0019 ou SYSLIB0020 sont générés à partir de votre build, passez en revue l’utilisation des API affectées. Si possible, évitez d’utiliser ces API et reportez-vous aux messages et à la documentation pour obtenir des alternatives. Si vous devez conserver les références aux API obsolètes et supprimer les diagnostics, supprimez les avertissements à l’aide des nouveaux ID de diagnostic au lieu de CS0618.

API affectées

Voir aussi