My.Application.ChangeUICulture Method
Changes the culture that the current thread uses for retrieving culture-specific resources.
' Usage
My.Application.ChangeUICulture(cultureName)
' Declaration
Public Sub ChangeUICulture( _
ByVal cultureName As String _
)
Parameters
- cultureName
String. Name of the culture as a string. For a list of possible names, see CultureInfo.
Exceptions
The following conditions can cause an exception:
The cultureName argument is Nothing (ArgumentNullException).
The cultureName argument is not a valid culture name (ArgumentException).
Remarks
The My.Application.ChangeUICulture method changes the current thread's CurrentUICulture property. The CurrentUICulture property determines the culture used by the Resource Manager and the My.Resources object; it uses this information to look up culture-specific resources at run time.
To retrieve the current UI culture, you can use the My.Application.UICulture Property or the CurrentUICulture property.
Use the My.Application.ChangeCulture method to change the culture that the current thread uses for string manipulation and string formatting.
Example
This example uses the My.Application.ChangeUICulture method to set the culture that the My.Resources Object uses for retrieving resources.
Sub ShowLocalizedMessage()
Dim culture As String = My.Application.UICulture.Name
My.Application.ChangeUICulture("fr-FR")
MsgBox(My.Resources.Message)
My.Application.ChangeUICulture(culture)
End Sub
For this example to work, your application must have a string named Message in the application's resource file, and the application should have the French-culture version of that resource file, Resources.fr-FR.resx. For more information, see How to: Add or Remove Resources.
If the application does not have the French-culture version of that resource file, the My.Resource object retrieves the resource from the default-culture resource file.
Requirements
Namespace:Microsoft.VisualBasic.ApplicationServices
Class:WindowsFormsApplicationBase, ApplicationBase
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Availability by Project Type
Project type |
Available |
|---|---|
Windows Application |
Yes |
Class Library |
Yes |
Console Application |
Yes |
Windows Control Library |
Yes |
Web Control Library |
No |
Windows Service |
Yes |
Web Site |
No |
Permissions
No permissions are required.
See Also
Tasks
How to: Retrieve Localized Resources in Visual Basic