Метод My.Application.ChangeCulture

Статья
11/05/2008

Обновлен: Ноябрь 2007

Изменяет язык и региональные параметры, используемые текущим потоком для обработки и форматирования строки.

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

Параметры

cultureName
String. Имя языка и региональных параметров в виде строки. Список возможных имен см. в разделе CultureInfo.

Исключения

Следующие условия могут создать исключение.

Аргумент cultureName имеет значение Nothing (ArgumentNullException).
Аргумент cultureName не является допустимым именем языка и региональных параметров (ArgumentException).

Заметки

Метод My.Application.ChangeCulture изменяет свойство CurrentCulture текущего потока. CurrentCulture определяет формат по умолчанию для дат, времени, валюты, чисел, порядка сортировки текста, сравнения строк и регистра для всех вычислений в этом потоке.

Чтобы извлечь текущий язык и региональные параметры, можно использовать свойство Свойство My.Application.Culture или CurrentCulture.

Параметр CurrentCulture отличается от языкового параметра. Он содержит только данные, относящиеся к стандартным параметрам для географического региона. Таким образом, свойство CurrentCulture может быть установлено на конкретный язык и региональные параметры или на InvariantCulture.

Метод My.Application.ChangeUICulture позволяет изменить языковую среду, которую текущий поток использует для извлечения ресурсов, связанных с языковой средой.

Примечание о безопасности.
Метод My.Application.ChangeCulture требует SecurityPermission с установленным флагом ControlThread. Управление потоками требует осторожности, поскольку с ними связано состояние безопасности. Поэтому такое разрешение должно предоставляться только надежному коду и только в случае необходимости. Нельзя изменять языковую среду потока в недостаточно надежном коде.

Метод My.Application.ChangeCulture требует SecurityPermission с установленным флагом ControlThread. Управление потоками требует осторожности, поскольку с ними связано состояние безопасности. Поэтому такое разрешение должно предоставляться только надежному коду и только в случае необходимости. Нельзя изменять языковую среду потока в недостаточно надежном коде.

Пример

В этом примере показано, как изменение языковой среды влияет на строковое представление даты.

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

Требования

Пространство имен:Microsoft.VisualBasic.ApplicationServices

Класс:WindowsFormsApplicationBase, ApplicationBase

Сборка: библиотека времени выполнения Visual Basic (в Microsoft.VisualBasic.dll)

Доступность по типу проекта

Тип проекта	Доступно
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Служба Windows	Да
Веб-узел	Нет

Разрешения

Могут потребоваться следующие разрешения.

Разрешение	Описание
SecurityPermission	Описывает набор разрешений безопасности, примененных к коду. Связанное перечисление: ControlThread.