Partager via

FilePatternMatch.Stem a changé en valeur non nullable

La FilePatternMatch.Stem propriété a été précédemment annotée comme nullable, car la PatternTestResult.Stem propriété à partir de laquelle elle obtient sa valeur est nullable. Même si le PatternTestResult résultat n’est pas réussi, le FilePatternMatch résultat n’est jamais dû au fait qu’il n’est construit qu’en cas PatternTestResult de réussite.

Pour refléter avec précision la valeur Nullabilité, l’attribut [MemberNotNullWhen()] est appliqué à la PatternTestResult.Stem propriété pour indiquer au compilateur qu’il ne sera pas null s’il réussit. En outre, l’argument stem passé dans le FilePatternMatch constructeur n’est plus nullable et un ArgumentNullException est levée si une valeur Null stem est passée.

Version introduite

.NET 10

Comportement précédent

Auparavant, le FilePatternMatch constructeur a accepté null pour le stem paramètre sans avertissements ou erreurs de compilation ou d’exécution.

// Allowed in previous versions.
var match = new FilePatternMatch("path/to/file.txt", null);

La FilePatternMatch.Stem propriété a également été annotée comme nullable.

Nouveau comportement

À compter de .NET 10, le passage d’une null valeur null ou éventuelle à l’argument stem dans le constructeur génère un avertissement au moment de la FilePatternMatch compilation. Et, si null est passé, une exception d'exécution ArgumentNullException est levée.

La FilePatternMatch.Stem propriété est désormais annotée pour indiquer que la valeur ne sera pas null si IsSuccessful elle est true.

// Generates compile-time warning.
var match = new FilePatternMatch("path/to/file.txt", null);

Type de changement cassant

Cette modification peut affecter la compatibilité de la source et est un changement comportemental.

Raison de la modification

Les annotations nullabilité précédentes étaient inexactes et une null valeur pour l’argument stem était inattendue, mais pas correctement protégée. Cette modification reflète le comportement attendu de l’API et protège contre le comportement imprévisible tout en produisant des conseils au moment du design autour de l’utilisation.

Si une valeur éventuellement null a été transmise pour l’argument stem , passez en revue l’utilisation et mettez à jour le site d’appel pour vous assurer stem qu’il ne peut pas être paTssed en tant que null.

Si vous avez appliqué des suppressions d’avertissement de nullabilité lors de la consommation de la FilePatternMatch.Stem propriété, vous pouvez supprimer ces suppressions.

API affectées

  • Last updated on