.NET Project Source | Options

Use this sheet to set options of .NET project file.

Items that localized resource files contain

Specifies what resource items are written to the localized resource files. Possible values are:

If you keep the default value, Translated, Sisulizer can greatly optimize the size of the resource files. This also will fully enable the build-in language fallback of the platform where you application runs. If you choose All no runtime language fallback is done but fallback is done by Sisulizer on build process. We recommend to use either Translated of Different to enabled optimization and language fallback of the platform.

Right to left layout and Set reading order property

Together Right to left layout radio group and Set reading order property check boxs specify how user interface should be modified when localizing to bi-directional languages such as Arabic, Hebrew and Persian. Depending on your platform you should set the check boxes in a different way.

Sort items

If checked Sisulizer adds the resource items alphabetically to the resource string node. If unchecked the items are added in the same order as they appear in the original file.

Private resources in satellite assemblies

If checked Sisulizer makes resources in satellite assemblies private.

Delete .resources files after the build process

If checked Sisulizer deletes the created .resources files after the build process.

Add language part into name of localized resources

If checked Sisulizer adds language specific part into the names of all localized resources. If unchecked Sisulizer adds culture specific part into the names of those resources that require it. The standard resource types such resources are ResX resources and XAML resources required the language part.

Let's have an example. You have embedded image resource called MyApplication.MyImage.png. When you read the image data on runtime you use "MyApplication.MyImage.png" name. If you check the check box Sisulizer will rename the resource in the localized satellite assembly file. The German assembly file will have MyApplication.MyImage.de.png" and Japanese file will have "MyApplication.MyImage.ja.png". In order to correctly read the image data your code must change the name it uses depending on the active locale. If you do not want this make sure that the check box is unchecked. In that case the satellite assembly files will all have the resource with the same name ("MyApplication.MyImage.png").

Compile main assembly file if it does not exist

If checked Sisulizer compiles the main assembly file before building localized files if the main assembly files does not exist.

Compile resource files

If checked Sisulizer compiles resource files (from .resx or .txt to .resources) when building localized files.

Create satellite assemblies

If checked Sisulizer creates satellite assemblies when building localized files.

Delete localized .resx files after the build process

If checked Sisulizer deletes the created .resx or .txt files after the build process.

Assembly linker (AL) parameters

This edit field specifies the parameters passed to assembly linker application (AL.exe). AL is used to create the localized satellite assembly files. Type the parameter values that you want to pass to the assembly linker, or right click to choose parameter template from a popup menu. The menu contains following templates:

Choose Clear to clear the parameters field.

A .NET project might have some default parameters that it requires. They are always passed to assembly linker. If any default parameters they are shown below the edit filed. For example if you have assigned a key file to the .NET project, Sisulizer will use the same key file for the localized satellite assembly files.

Read more about .NET localization.