CA1303: Do not pass literals as localized parameters


For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.

Breaking ChangeNon Breaking

A method passes a string literal as a parameter to a constructor or method in the .NET Framework class library and that string should be localizable.

This warning is raised when a literal string is passed as a value to a parameter or property and one or more of the following cases is true:

  • The LocalizableAttribute attribute of the parameter or property is set to true.

  • The parameter or property name contains "Text", "Message", or "Caption".

  • The name of the string parameter that is passed to a Console.Write or Console.WriteLine method is either "value" or "format".

String literals that are embedded in source code are difficult to localize.

To fix a violation of this rule, replace the string literal with a string retrieved through an instance of the ResourceManager class.

It is safe to suppress a warning from this rule if the code library will not be localized, or if the string is not exposed to the end user or a developer using the code library.

Users can eliminate noise against methods which should not be passed localized strings by either renaming the parameter or property named, or by marking these items as conditional.

The following example shows a method that throws an exception when either of its two arguments are out of range. For the first argument, the exception constructor is passed a literal string, which violates this rule. For the second argument, the constructor is correctly passed a string retrieved through a ResourceManager.

using namespace System;
using namespace System::Globalization;
using namespace System::Reflection;
using namespace System::Resources;
using namespace System::Windows::Forms;

[assembly: NeutralResourcesLanguageAttribute("en-US")];
namespace GlobalizationLibrary
    public ref class DoNotPassLiterals
        ResourceManager^ stringManager;

            stringManager = 
                gcnew ResourceManager("en-US", Assembly::GetExecutingAssembly());

        void TimeMethod(int hour, int minute)
            if(hour < 0 || hour > 23)
                    "The valid range is 0 - 23."); //CA1303 fires because the parameter for method Show is Text

            if(minute < 0 || minute > 59)
                    stringManager->GetString("minuteOutOfRangeMessage", CultureInfo::CurrentUICulture));

Resources in Desktop Apps