CultureInfo.GetConsoleFallbackUICulture Method

public:
 System::Globalization::CultureInfo ^ GetConsoleFallbackUICulture();

public System.Globalization.CultureInfo GetConsoleFallbackUICulture ();

[System.Runtime.InteropServices.ComVisible(false)]
public System.Globalization.CultureInfo GetConsoleFallbackUICulture ();

member this.GetConsoleFallbackUICulture : unit -> System.Globalization.CultureInfo

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.GetConsoleFallbackUICulture : unit -> System.Globalization.CultureInfo

Public Function GetConsoleFallbackUICulture () As CultureInfo

Returns

An alternate culture that is used to read and display text on the console.

Attributes

ComVisibleAttribute

Examples

The following code example displays the fallback user interface culture associated with a culture object.

// This example demonstrates the GetConsoleFallbackUICulture() method
using namespace System;
using namespace System::Globalization;

int main()
{
    CultureInfo^ ci = gcnew CultureInfo("ar-DZ");
    Console::WriteLine("Culture name: . . . . . . . . . {0}", ci->Name);
    Console::WriteLine("Console fallback UI culture:. . {0}",
        ci->GetConsoleFallbackUICulture()->Name);
}
/*
This code example produces the following results:

Culture name: . . . . . . . . . ar-DZ
Console fallback UI culture:. . fr-FR

*/

// This example demonstrates the GetConsoleFallbackUICulture() method
using System;
using System.Globalization;

class Sample
{
    public static void Main()
    {
    CultureInfo ci = new CultureInfo("ar-DZ");
    Console.WriteLine("Culture name: . . . . . . . . . {0}", ci.Name);
    Console.WriteLine("Console fallback UI culture:. . {0}",
                       ci.GetConsoleFallbackUICulture().Name);
    }
}
/*
This code example produces the following results:

Culture name: . . . . . . . . . ar-DZ
Console fallback UI culture:. . fr-FR

*/

' This example demonstrates the GetConsoleFallbackUICulture() method
Imports System.Globalization

Class Sample
   Public Shared Sub Main()
      Dim ci As New CultureInfo("ar-DZ")
      Console.WriteLine("Culture name: . . . . . . . . . {0}", ci.Name)
      Console.WriteLine("Console fallback UI culture:. . {0}", _
                         ci.GetConsoleFallbackUICulture().Name)
   End Sub
End Class
'
'This code example produces the following results:
'
'Culture name: . . . . . . . . . ar-DZ
'Console fallback UI culture:. . fr-FR
'

Remarks

Languages such as Arabic, Hebrew, Urdu, and Syriac are based on bidirectional text. Windows applications, which have a graphical user interface, support bidirectional languages. However, console applications, which employ the text user interface of the operating system console, do not provide bidirectional support. Therefore, if you localize a console application to Arabic or Hebrew, your application displays unreadable text on the console screen.

The user interface culture specifies the resources an application needs to support user input and output, and by default is the same as the operating system culture. For example, the CultureInfo.CurrentUICulture property returns an Arabic culture for an Arabic operating system. Use the GetConsoleFallbackUICulture method to retrieve a culture suitable for a console application user interface. After your application retrieves the fallback user interface culture, it should assign the culture to the current user interface culture of the current thread. For more information, see the "Explicitly Setting the Current UI Culture" section of the CurrentUICulture property.

The following are predefined cultures that have a different fallback user interface culture name from the predefined culture name.

Your application can use CultureAndRegionInfoBuilder to create a replacement for a culture, and that culture can have a console fallback culture of your choosing.

Applies to