CA1304 : Spécifier CultureInfoCA1304: Specify CultureInfo

TypeNameTypeName SpecifyCultureInfoSpecifyCultureInfo
CheckIdCheckId CA1304CA1304
CategoryCategory Microsoft.GlobalizationMicrosoft.Globalization
Modification avec ruptureBreaking Change Sans ruptureNon-breaking

CauseCause

Une méthode ou un constructeur appelle un membre qui a une surcharge qui accepte un System.Globalization.CultureInfo paramètre et la méthode ou le constructeur n’appelle pas la surcharge qui accepte le CultureInfo paramètre.A method or constructor calls a member that has an overload that accepts a System.Globalization.CultureInfo parameter, and the method or constructor does not call the overload that takes the CultureInfo parameter. Cette règle ignore les appels aux méthodes suivantes :This rule ignores calls to the following methods:

Description de la règleRule description

Quand un CultureInfo ou System.IFormatProvider objet n’est pas fourni, la valeur par défaut qui est fournie par le membre surchargé n’est peut-être pas l’effet souhaité dans tous les paramètres régionaux.When a CultureInfo or System.IFormatProvider object is not supplied, the default value that is supplied by the overloaded member might not have the effect that you want in all locales. En outre, les membres de .NET Framework choisissent la culture par défaut et mise en forme basée sur des hypothèses qui peuvent ne pas être correctes pour votre code.Also, .NET Framework members choose default culture and formatting based on assumptions that might not be correct for your code. Pour que le code fonctionne comme prévu pour vos scénarios, vous devez fournir des informations spécifiques à la culture selon les consignes suivantes :To ensure the code works as expected for your scenarios, you should supply culture-specific information according to the following guidelines:

  • Si la valeur doit être affichée à l’utilisateur, utilisez la culture actuelle.If the value will be displayed to the user, use the current culture. Consultez CultureInfo.CurrentCulture.See CultureInfo.CurrentCulture.

  • Si la valeur est stockée et accessibles par le logiciel, c'est-à-dire, rendues persistantes dans un fichier ou d’une base de données, utilisez la culture dite indifférente.If the value will be stored and accessed by software, that is, persisted to a file or database, use the invariant culture. Consultez CultureInfo.InvariantCulture.See CultureInfo.InvariantCulture.

  • Si vous ne connaissez pas la destination de la valeur, ont le consommateur de données ou le fournisseur de spécifier la culture.If you do not know the destination of the value, have the data consumer or provider specify the culture.

Même si le comportement par défaut du membre surchargé est adapté à vos besoins, il est préférable d’appeler explicitement la surcharge spécifique à la culture afin que votre code soit documentés et plus facile à maintenir.Even if the default behavior of the overloaded member is appropriate for your needs, it is better to explicitly call the culture-specific overload so that your code is self-documenting and more easily maintained.

Note

CultureInfo.CurrentUICulture est utilisé uniquement pour récupérer des ressources localisées à l’aide d’une instance de la System.Resources.ResourceManager classe.CultureInfo.CurrentUICulture is used only to retrieve localized resources by using an instance of the System.Resources.ResourceManager class.

Comment corriger les violationsHow to fix violations

Pour corriger une violation de cette règle, utilisez la surcharge qui accepte un CultureInfo argument.To fix a violation of this rule, use the overload that takes a CultureInfo argument.

Quand supprimer les avertissementsWhen to suppress warnings

Il est possible de supprimer un avertissement de cette règle lorsque vous êtes certain que la culture par défaut est le bon choix, et où la maintenabilité du code n’est pas une priorité de développement importants.It is safe to suppress a warning from this rule when it is certain that the default culture is the correct choice, and where code maintainability is not an important development priority.

Exemple montrant comment corriger les violationsExample showing how to fix violations

Dans l’exemple suivant, BadMethod provoque deux violations de cette règle.In the following example, BadMethod causes two violations of this rule. GoodMethod corrige la première violation en passant la culture dite indifférente pour String.Compareet corrige la seconde en passant la culture actuelle à String.ToLower car string3 est affiché à l’utilisateur.GoodMethod corrects the first violation by passing the invariant culture to String.Compare, and corrects the second violation by passing the current culture to String.ToLower because string3 is displayed to the user.

using System;
using System.Globalization;

namespace GlobalizationLibrary
{
    public class CultureInfoTest
    {
        public void BadMethod(String string1, String string2, String string3)
        {
            if(string.Compare(string1, string2, false) == 0)
            {
                Console.WriteLine(string3.ToLower());
            }
        }

        public void GoodMethod(String string1, String string2, String string3)
        {
            if(string.Compare(string1, string2, false, 
                              CultureInfo.InvariantCulture) == 0)
            {
                Console.WriteLine(string3.ToLower(CultureInfo.CurrentCulture));
            }
        }
    }
}

Affichage de l’exemple de sortie mise en formeExample showing formatted output

L’exemple suivant montre l’effet de la culture actuelle sur la valeur par défaut IFormatProvider qui est sélectionné par le DateTime type.The following example shows the effect of current culture on the default IFormatProvider that is selected by the DateTime type.

using System;
using System.Globalization;
using System.Threading;

namespace GlobalLibGlobalLibrary
{
    public class IFormatProviderTest
    {
        public static void Main()
        {
            string dt = "6/4/1900 12:15:12";

            // The default behavior of DateTime.Parse is to use
            // the current culture.
            
            // Violates rule: SpecifyIFormatProvider.
            DateTime myDateTime = DateTime.Parse(dt);
            Console.WriteLine(myDateTime);
            
            // Change the current culture to the French culture,
            // and parsing the same string yields a different value.
            
            Thread.CurrentThread.CurrentCulture = new CultureInfo("Fr-fr", true);
            myDateTime = DateTime.Parse(dt);
            
            Console.WriteLine(myDateTime);
        }
    }
}

Cet exemple génère la sortie suivante :This example produces the following output:

4/6/1900 12 H 15:126/4/1900 12:15:12 PM

06/04/1900 12:15:1206/04/1900 12:15:12

Voir aussiSee also