ApplicationBase.ChangeCulture メソッド

.NET Framework クラス ライブラリ リファレンス

ApplicationBase.ChangeCulture メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在のスレッドが文字列の操作と書式設定に使用しているカルチャを変更します。

名前空間: Microsoft.VisualBasic.ApplicationServices
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Sub ChangeCulture ( _
    cultureName As String _
)

Visual Basic (使用法)

Dim instance As ApplicationBase
Dim cultureName As String

instance.ChangeCulture(cultureName)

C#

public void ChangeCulture (
    string cultureName
)

C++

public:
void ChangeCulture (
    String^ cultureName
)

J#

public void ChangeCulture (
    String cultureName
)

JScript

public function ChangeCulture (
    cultureName : String
)

パラメータ

cultureName

カルチャの名前を表す文字列 (String)。使用可能な名前の一覧については、「CultureInfo」を参照してください。

解説

詳細については、Visual Basic のトピック「My.Application.ChangeCulture メソッド」を参照してください。

My.Application.ChangeCulture メソッドは、現在のスレッドの CurrentCulture プロパティを変更します。CurrentCulture は、そのスレッド上で行われるすべての演算について、日付、時刻、通貨、数値の既定の書式、テキストの並べ替え、文字列比較、大文字と小文字の区別を決定します。

My.Application.Culture プロパティ プロパティまたは CurrentCulture プロパティを使用して、現在のカルチャを取得できます。

CurrentCulture 設定は、言語設定とは異なります。地域ごとの標準的な設定に関連したデータしか保持されません。したがって、CurrentCulture プロパティは、特定のカルチャまたは InvariantCulture に設定する必要があります。

現在のスレッドがカルチャ固有のリソースを検索する際に用いるカルチャを変更するには、My.Application.ChangeUICulture メソッドを使用します。

セキュリティに関するメモ
My.Application.ChangeCulture メソッドでは、SecurityPermission に ControlThread が設定されている必要があります。スレッドに関連付けられているセキュリティ状態が理由で、スレッド操作は危険です。このため、このアクセス許可は、信頼できるコードに必要な場合だけ与えてください。信頼度の低いコード内では、スレッドのカルチャは変更できません。

使用例

この例では、日付の文字列表現に、カルチャがどのような影響を与えるかを示しています。

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ApplicationBase クラス
ApplicationBase メンバ
Microsoft.VisualBasic.ApplicationServices 名前空間
ApplicationBase.ChangeCulture
CurrentCulture
その他の技術情報
My.Application.ChangeCulture メソッド
My.Application オブジェクト
My.Application.Culture プロパティ
My.Application.ChangeUICulture メソッド