My.Application.ChangeCulture (Método)

Actualización: noviembre 2007

Cambia la referencia cultural utilizada por el subproceso actual para la manipulación de cadenas de caracteres y para el formato de las cadenas.

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

Parámetros

• cultureName
  String. Nombre de la referencia cultural como una cadena. Para obtener una lista de los posibles nombres, 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 referencia cultural válido (ArgumentException).

Comentarios

El método My.Application.ChangeCulture cambia la propiedad CurrentCulture actual del subproceso. CurrentCulture determina los formatos predeterminados de fecha, hora, moneda, número, ordenación del texto, comparaciones de cadenas y formato de mayúsculas y minúsculas de todos los cálculos de ese subproceso.

Para recuperar la referencia cultural actual, puede utilizar las propiedades My.Application.Culture (Propiedad) o CurrentCulture.

La configuración de CurrentCulture es diferente de la configuración de idioma. Sólo contiene datos relacionados con la configuración estándar para una región geográfica. Por lo tanto, la propiedad CurrentCulture únicamente se puede establecer en una referencia cultural específica o en InvariantCulture.

Utilice el método My.Application.ChangeUICulture para cambiar la referencia cultural que utiliza el subproceso actual para recuperar los recursos específicos de la referencia cultural.

Nota de seguridad:
El método My.Application.ChangeCulture requiere un permiso SecurityPermission con el conjunto ControlThread establecido. Es peligroso manipular subprocesos por el estado de seguridad asociado a los mismos. Por consiguiente, este permiso sólo se debería dar como obligatorio al código de confianza. No se puede cambiar la referencia cultural de un subproceso en un código de confianza parcial.

Ejemplo

Este ejemplo muestra cómo al cambiar la referencia cultural también cambia la representación de las cadenas de fecha.

Private Sub TestChangeCulture()
    ' Store the current culture.
    Dim currentculture As String = My.Application.Culture.Name
    MsgBox("Current culture is " & currentculture)

    Dim jan1 As New Date(2005, 1, 1, 15, 15, 15)

    My.Application.ChangeCulture("en-US")
    MsgBox("Date represented in en-US culture: " & jan1)
    ' 1/1/2005 3:15:15 PM

    My.Application.ChangeCulture("")
    MsgBox("Date represented in invariant culture" & jan1)
    ' 01/01/2005 15:15:15

    ' Restore the culture.
    My.Application.ChangeCulture(currentculture)
End Sub

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

Permisos

El permiso siguiente puede ser necesario:

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Referencia

My.Application (Objeto)

My.Application.Culture (Propiedad)

My.Application.ChangeUICulture (Método)

ApplicationBase.ChangeCulture

CurrentCulture