My.Application.ChangeUICulture (Método)

Artículo
08/23/2008

Actualización: noviembre 2007

Cambia la referencia cultural que el subproceso actual utiliza para recuperar los recursos específicos de la referencia cultural.

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

Parámetros

cultureName
String. Nombre de la referencia cultural como cadena. Para obtener una lista de los nombres posibles, vea CultureInfo.

Excepciones

Las circunstancias siguientes pueden provocar una excepción:

El argumento cultureName es Nothing (ArgumentNullException).
El argumento cultureName no es un nombre de la referencia cultural válido (ArgumentException).

Comentarios

El método My.Application.ChangeUICulture cambia la propiedad CurrentUICulture del subproceso actual. La propiedad CurrentUICulture determina la referencia cultural que utilizan el Administrador de recursos y el objeto My.Resources; esta información se utiliza para buscar recursos específicos de la referencia cultural en tiempo de ejecución.

Para recuperar la referencia cultural de la interfaz de usuario actual, puede utilizar las propiedades My.Application.UICulture (Propiedad) o CurrentUICulture.

Utilice el método My.Application.ChangeCulture para cambiar la referencia cultural que el subproceso actual utiliza para la manipulación de cadenas de caracteres y el formato de la cadena.

Ejemplo

En este ejemplo se utiliza el método My.Application.ChangeUICulture a fin de establecer la referencia cultural que My.Resources (Objeto) utiliza para recuperar los 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 ejemplo funcione, la aplicación debe tener una cadena denominada Message en el archivo de recursos de la aplicación y ésta debe tener la versión de la referencia cultural francesa de ese archivo de recursos, Resources.fr-FR.resx. Para obtener más información, vea Cómo: Agregar o quitar recursos.

Si la aplicación no tiene la versión de la referencia cultural francesa de ese archivo de recursos, el objeto My.Resource recupera el recurso del archivo de recursos de la referencia cultural predeterminada.

Requisitos

Espacio de nombres:Microsoft.VisualBasic.ApplicationServices

Clase:WindowsFormsApplicationBase, ApplicationBase

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Tipo de proyecto	Disponible
Aplicación para Windows	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	No
Servicio de Windows	Sí
Sitio Web	No