Namespace Sdl.Core.Globalization

Classes

Codepage

Represents a code page in the sense of a System.Text.Encoding object, using a mechanism that allows basic manipulations on a system where support for the code page may not be installed.

Normally the Codepage object is constructed from an Encoding object, but for persistence it can be constructed from a string.

If the code page is supported by the local machine you can use the Encoding property to retrieve the corresponding .NET encoding object. If you access this property for a code page that is not supported on this machine this will result in a UnsupportedCodepageException.

Using this mechanism as opposed to directly using the Encoding class means that we can still work with files for which a code page is not supported on a certain machine (at least as long as no code page conversion operations are needed). This may be a common use case when a file is converted on one system and then edited on another.

Use the IsValid and IsSupported properties to determine if the codepage has been set and if it is supported on this system.

Language

Represents a language in the sense of a System.Globalization.CultureInfo object, using a mechanism that allows basic manipulations on a system where the language is not fully supported.

The reason we use this type as opposed to the CultureInfo class in the .NET Framework is that when working with files we may convert the file on a system that supports a particular language (i.e. the CultureInfo for this language abbreviation is known), but the file may subsequently be opened on a system that does not yet have support for this language.

Depending on what processing is to be done this may be a perfectly valid use case, and it would be too harsh a restriction to require support for the language to be installed on all systems that may ever look at the file.

Under normal circumstances the language should be created from a CultureInfo object.

In addition this wrapper allows a language to be represented by a plain string when no CultureInfo for this language is supported on the system, and thus allows the language to be represented until some truly language specific processing is needed (i.e. when the corresponding CultureInfo is required).

When supported by the operating system the corresponding CultureInfo can be obtained directly from the CultureInfo property. If not supported this will throw an UnsupportedLanguageException.

Use the IsValid and IsSupported properties to determine if the language has been set and whether it is supported by the operating system.

LanguageCancelEventArgs

Cancel event args class for language-related events

LanguageDisplaySettings

Used in DefaultDisplaySettings to control how languages are displayed to the users for the entire process.

LanguageEventArgs

Event args class for language-related events

LegacySdlxLanguage

Used to find CultureInfo and LCID values from a given SDLX 'iso' code.

LocalizableString

Data type used for strings in Spring configuration files that may need to be localized.

UnsupportedCodepageException

Thrown by the Codepage class if attempting to access the Encoding property on a system that does not support this encoding.

UnsupportedLanguageException

Thrown by the Language class if attempting to access the CultureInfo property on a system where the language is not supported.

Structs

LegacyTradosLanguage

Represents a project language in the client object model

Enums

ConfirmationLevel

The approval level of the translation of a segment

LanguageFormat

Exposes the various acceptable values language format can take in TeamWorks.