Locale: LocaleCodeID;
The Locale property determines the language used for attribute value search to identify elements.
The property is not set by default, the following work algorithm is used (the current language of repository, the language selected in the repository on dictionary creation and the binding mode are taken into account):
Binding is executed directly to attribute. On import elements are searched by the translation matching the current repository language. If this translation is missing, elements are searched by the language, which was set on creating a dictionary. If the value is not found in translations, a new element is created. The imported value is set for all languages, into which the dictionary is translated.
Binding is executed to attribute translation (current repository language matches the language that was set on creating a dictionary) and:
Attribute translation matches the language that was set on creating a dictionary. Elements are searched only by this attribute values.
Attribute translation matches the current repository language. Elements are searched only by this attribute values. Values in the language that was set on creating a dictionary are not taken into account.
Attribute translation does not match the current repository language. Elements are searched only by this attribute values. Values in the language that was set on creating a dictionary are not taken into account.
Binding is executed to several attribute translations and:
One of translations matches the current repository language. Elements are searched by this translation. Values in the language that was set on creating a dictionary are not taken into account. On creating new elements, values are imported according to the specified bindings. Value in the current repository language is imported as a value of translation into the language that was set on creating a dictionary.
None of translations matches the current repository language. Elements are searched by translation to the language that was set on creating a dictionary. On creating new elements, values are imported according to the specified bindings. Value of the first translation is imported as a value of translation into the language that was set on creating a dictionary.
Binding is executed directly to the attribute and one (several) attribute translations. Elements are searched by the translation matching the current repository language. Values are imported according to the specified bindings.
If the Locale property is not set, the value search is made by attribute, which corresponds to the selected language.
See also: