Multi-Language for Visual Studio

Code Analysis and Code Fix

Starting with Version 7.2, Multi-Language for Visual Studio contains a code analysis and several associated code fixes.

What does it check?

Every code analysis checks a rule. Lets start by looking at what the rule is.

Every string in your source code should be either

1. localized or
2. marked as not requiring localization (hidden)

Why is this important?

In particular, why is it important to mark strings which do not require localization?

This is important for two reasons:

What is a code analysis?

A code analysis is a rule that is applied in the background. If the rule is violated, then the code which violates the rule is underlined with a wavy green line.

There is some general information about code analyzers on this page.

What is a code fix?

A code fix is a change that can be made to your code, so that the rule is satisfied. There may be one or more code fixes for any rule.

The code fixes appear in the menu below the light bulb icon. This appears in the left hand margin, or next to the code, if you hold the mouse pointer over the code with the wavy green line.

When is the Multi-Language code analysis active?

The code analysis is active on any project which is already using Multi-Language.

Multi-Language adds a project database file (usually ProjectName_ml.xml) to the project, so the code analysis should be active if this file is present in your project.

In addition, the code analysis can be enabled and disabled in the project settings dialog, as shown below. By default, the code analysis is enabled.

It is not necessary to scan the project using the the Multi-Language tool window.

What exactly does the Multi-Language Code-Analysis check?

The code analysis checks the strings and interpolated strings in the source code files (C# and VB).

For each string, it checks whether it is "hidden" ...

//MLHIDEON
private string templatefile = "template.cs" ;
private string logfile      = "logfile.txt" ;
private string helpfile     = "helpfile.chm" ;
//MLHIDEOFF

public string junk()
{
  string hello = (("Hello World")) ;
  return hello ;
}

public string junk()
{
  string hello = "Hello World" ;    //MLHIDE
  return hello ;
}

Any string which is not ignored for one of the reasons listed above violates the rule.

What code fixes are available?

There are generally three possible code fixes:

• hide the string in double brackets
• hide the string using the comment MLHIDE
• localize the string

In each case, a preview window shows the exact code change, before it is made.

Disable localization with double brackets

This has already been described in the table above.

If there is only one string on the line, I generally prefer to use the MLHIDE comment instead of this method, because the syntax is a bit odd.

If there are multiple strings on a single line, this method has the advantage of of applying only to one string, and not to the whole line.

Disable localization with the comment MLHIDE

This has already been described in the table above.

If there are multiple strings on the line, this method has the disadvantage of hiding them all (but it has the advantage of simplicity).

Localize with a resource

This option is available if you have chosen to localize texts using so called "Named Resources".

Localize with the function ml_string()

Localize with the IStringLocalizer method