ApplicationBase.ChangeUICulture(String) Método

Definição

Namespace:

Microsoft.VisualBasic.ApplicationServices

Assembly:

Microsoft.VisualBasic.Forms.dll

Origem:

ApplicationBase.vb

Altera a cultura que o thread atual usa para recuperar recursos específicos de cultura.

public:
 void ChangeUICulture(System::String ^ cultureName);

public void ChangeUICulture (string cultureName);

member this.ChangeUICulture : string -> unit

Public Sub ChangeUICulture (cultureName As String)

Parâmetros

cultureName

String

String. Nome da cultura como uma cadeia de caracteres. Para obter uma lista de nomes possíveis, consulte CultureInfo.

Exceções

ArgumentNullException

cultureName é Nothing.

ArgumentException

cultureName não é um nome de cultura válido.

Exemplos

Este exemplo usa o My.Application.ChangeUICulture método para definir a cultura que o My.Resources objeto usa para recuperar recursos.

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

Para que este exemplo funcione, seu aplicativo deve ter uma cadeia de caracteres chamada Message no arquivo de recurso do aplicativo e o aplicativo deve ter a versão de cultura francesa desse arquivo de recurso, Resources.fr-FR.resx. Para obter mais informações, consulte Como adicionar ou remover recursos.

Se o aplicativo não tiver a versão de cultura francesa desse arquivo de recurso, o My.Resources objeto recuperará o recurso do arquivo de recurso de cultura padrão.

Comentários

O My.Application.ChangeUICulture método altera a propriedade do CurrentUICulture thread atual. A CurrentUICulture propriedade determina a cultura usada pelo Resource Manager e pelo My.Resources objeto ; ela usa essas informações para pesquisar recursos específicos da cultura em tempo de execução.

Para recuperar a cultura de interface do usuário atual, você pode usar a UICulture propriedade ou a CurrentUICulture propriedade .

Use o My.Application.ChangeCulture método para alterar a cultura que o thread atual usa para manipulação de cadeia de caracteres e formatação de cadeia de caracteres.

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows Forms	Sim
Biblioteca de Classes	Sim
Aplicativo do Console	Sim
Biblioteca de Controle Windows Forms	Sim
Biblioteca de Controles da Web	Não
Serviço do Windows	Sim
Site	Não

Confira também

• Objetos (Visual Basic)