アプリケーションのリソースにアクセスするためのプロパティとクラスを提供します。
注釈
My.Resources オブジェクトは、アプリケーションのリソースへのアクセスを提供し、アプリケーションのリソースを動的に取得できます。 詳細については、「 アプリケーション リソースの管理 (.NET)」を参照してください。
My.Resources オブジェクトは、グローバル リソースのみを公開します。 フォームに関連付けられているリソース ファイルへのアクセスは提供されません。 フォームからフォーム リソースにアクセスする必要があります。
My.Resources オブジェクトからアプリケーションのカルチャ固有のリソース ファイルにアクセスできます。 既定では、 My.Resources オブジェクトは、 UICulture プロパティのカルチャに一致するリソース ファイルからリソースを検索します。 ただし、この動作をオーバーライドし、リソースに使用する特定のカルチャを指定できます。 詳細については、「 .NET アプリのリソース」を参照してください。
プロパティ
My.Resources オブジェクトのプロパティは、アプリケーションのリソースへの読み取り専用アクセスを提供します。 リソースを追加または削除するには、 プロジェクト デザイナーを使用します。
My.Resources.
resourceName を使用して、プロジェクト デザイナーから追加されたリソースにアクセスできます。
ソリューション エクスプローラーでプロジェクトを選択し、[プロジェクト] メニューの [新しい項目の追加] または [既存の項目の追加] をクリックして、リソース ファイルを追加または削除することもできます。 この方法で追加されたリソースには、 My.Resources.resourceFileName.resourceName を使用してアクセスできます。
各リソースには名前、カテゴリ、および値があり、これらのリソース設定によって、リソースにアクセスするプロパティが My.Resources オブジェクトにどのように表示されるかが決まります。
プロジェクト デザイナーで追加されたリソースの場合:
名前によってプロパティの名前が決まります。
リソース データはプロパティの値です。
カテゴリによって、プロパティの型が決まります。
| カテゴリ | プロパティのデータ型 |
|---|---|
| 文字列 | ストリング |
| 画像 | Bitmap |
| アイコン | Icon |
| オーディオ | UnmanagedMemoryStream UnmanagedMemoryStream クラスは Stream クラスから派生しているため、Play メソッドなどのストリームを受け取るメソッドで使用できます。 |
| ファイル |
- テキスト ファイルの文字列。 - Bitmap イメージ ファイルの場合は〘。 - Icon アイコン ファイルの場合は 〗。 - UnmanagedMemoryStream サウンド ファイル用。 |
| その他 | デザイナーの [型 ] 列の情報によって決定されます。 |
クラス
My.Resources オブジェクトは、各リソース ファイルを共有プロパティを持つクラスとして公開します。 クラス名は、リソース ファイルの名前と同じです。 前のセクションで説明したように、リソース ファイル内のリソースは、クラスのプロパティとして公開されます。
例 1
次の使用例は、フォームのタイトルを、アプリケーション リソース ファイル内の Form1Title という名前の文字列リソースに設定します。 この例を機能させるには、アプリケーションのリソース ファイルに Form1Title という名前の文字列が必要です。
Sub SetFormTitle()
Me.Text = My.Resources.Form1Title
End Sub
例 2
次の使用例は、フォームのアイコンを、アプリケーションのリソース ファイルに格納されている Form1Icon という名前のアイコンに設定します。 この例を機能させるには、アプリケーションのリソース ファイルに Form1Icon という名前のアイコンが必要です。
Sub SetFormIcon()
Me.Icon = My.Resources.Form1Icon
End Sub
例 3
次の使用例は、フォームの背景イメージを、アプリケーション リソース ファイルにある Form1Background という名前のイメージ リソースに設定します。 この例を機能させるには、アプリケーションのリソース ファイルに Form1Background という名前のイメージ リソースが必要です。
Sub SetFormBackgroundImage()
Me.BackgroundImage = My.Resources.Form1Background
End Sub
例 4
次の使用例は、アプリケーションのリソース ファイルに Form1Greeting という名前のオーディオ リソースとして格納されているサウンドを再生します。 この例を機能させるには、アプリケーションのリソース ファイルに Form1Greeting という名前のオーディオ リソースが必要です。
My.Computer.Audio.Play メソッドは、Windows フォーム アプリケーションでのみ使用できます。
Sub PlayFormGreeting()
My.Computer.Audio.Play(My.Resources.Form1Greeting,
AudioPlayMode.Background)
End Sub
例 5
この例では、アプリケーションの文字列リソースのフランス語カルチャ バージョンを取得します。 リソースには Message という名前が付けられます。 この例では、 My.Resources オブジェクトが使用するカルチャを変更するために、 ChangeUICultureを使用します。
この例を機能させるには、アプリケーションのリソース ファイルに Message という名前の文字列が必要です。アプリケーションには、そのリソース ファイル Resources のフランス語カルチャ バージョンが必要です。.resxfr-FR。 アプリケーションにフランス語カルチャバージョンのリソース ファイルがない場合、 My.Resource オブジェクトは、既定のカルチャ リソース ファイルからリソースを取得します。
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
こちらも参照ください
.NET