Método My.aplicativo.ChangeUICulture

Artigo
08/25/2010

Modifica a cultura que o segmento atual usa para recuperar recursos específicos da cultura.

' Usage
My.Application.ChangeUICulture(cultureName)
' Declaration
Public Sub ChangeUICulture( _
   ByVal cultureName As String _
)

Parâmetros

cultureName
String.Nome da cultura sistema autônomo uma seqüência de caracteres.Para obter uma lista dos nomes possíveis, consulte CultureInfo.

Exceções

As condições a seguir podem causar uma exceção:

O argumento cultureName é Nothing (ArgumentNullException).
O argumento cultureName não é um nome válido de cultura (ArgumentException).

Comentários

The My.Application.ChangeUICulture método altera thread's corrente CurrentUICulture propriedade. The CurrentUICulture propriedade determina a cultura usada pelo Gerenciador de recursos e o My.Resources objeto; ele usa essas informações para pesquisar recursos específicos da cultura em time de execução.

Para recuperar a cultura UI corrente, você pode usar o Propriedade My.Application.UICulture ou o CurrentUICulture propriedade.

Use o My.Application.ChangeCulture método para alterar a cultura que usa o thread corrente para manipulação de seqüência de caracteres e seqüência de caracteres de formatação.

Exemplo

Este exemplo usa o My.Application.ChangeUICulture método para a cultura do conjunto que o Objeto My.Resources usa para recuperação de 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 esse exemplo funcione, seu aplicativo deve ter uma sequência de caracteres chamada Message Na arquivo de recurso do aplicativo, e o aplicativo deve ter a versão do que arquivo de recurso, Resources.fr-FR.resx Francês-culture.Para obter mais informações, consulte Como: Adicionar ou remover recursos.

Se o aplicativo não tiver a versão de cultura francesa do arquivo de recursos, o objeto My.Resource recupera o recurso do arquivo de recursos da cultura padrão.

Requisitos

Namespace:Microsoft.VisualBasic.ApplicationServices

Classe:WindowsFormsApplicationBase, ApplicationBase

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Não
Serviço do Windows	Sim
Site	Não