My.Resources オブジェクト

更新 : 2007 年 11 月

アプリケーションのリソースにアクセスするための、プロパティとクラスを提供します。

解説

My.Resources オブジェクトを使用すると、アプリケーションのリソースへのアクセスが可能になり、アプリケーションに必要なリソースを動的に取得できるようになります。詳細については、「アプリケーション リソースの管理」を参照してください。

My.Resources オブジェクトはグローバルなリソースだけを公開します。フォームに関連付けられたリソース ファイルへのアクセスはできません。フォームのリソースには、フォームからアクセスする必要があります。詳細については、「チュートリアル : Windows フォームのローカリゼーション」を参照してください。

アプリケーションのカルチャ固有のリソース ファイルに、My.Resources オブジェクトからアクセスできます。既定では、My.Resources オブジェクトは、My.Application.UICulture プロパティ のカルチャに一致するリソース ファイルからリソースを検索します。ただし、この動作をオーバーライドして、リソースに使用するカルチャを指定することもできます。詳細については、「アプリケーションのリソース」を参照してください。

プロパティ

My.Resources オブジェクトのプロパティでは、アプリケーションのリソースに読み取り専用でしかアクセスできません。リソースを追加または削除するには、プロジェクト デザイナ を使用します。詳細については、「方法 : リソースを追加または削除する」を参照してください。プロジェクト デザイナで追加されたリソースには、My.Resources.resourceName を使用してアクセスできます。

また、ソリューション エクスプローラからプロジェクトを選択し、[プロジェクト] メニューの [新しい項目の追加] または [既存項目の追加] をクリックすることによっても、リソース ファイルを追加または削除できます。この方法で追加したリソースには、My.Resources.resourceFileName.resourceName を使用してアクセスできます。

各リソースには名前、カテゴリ、値が定義され、これらのリソース設定によってプロパティが My.Resources オブジェクトに含まれるリソースにアクセスする方法が決まります。プロジェクト デザイナ で追加されたリソースの場合は、次のようになります。

• 名前はプロパティの名前

• リソース データはプロパティの値

• カテゴリはプロパティの種類

  カテゴリ	プロパティのデータ型
  文字列	文字列
  イメージ	Bitmap
  アイコン	Icon
  Audio	UnmanagedMemoryStream UnmanagedMemoryStream クラスは Stream から派生しているため、ストリームを受け取るメソッド (My.Computer.Audio.Play メソッド など) で使用できます。
  ファイル	テキスト ファイルの場合は文字列。 イメージ ファイルの場合は Bitmap。 アイコン ファイルの場合は Icon。 サウンド ファイルの場合は UnmanagedMemoryStream。
  その他	デザイナの [型] 列の情報によって決まります。

クラス

My.Resources オブジェクトは各リソース ファイルを、共有プロパティを持つクラスとして公開します。クラス名はリソース ファイルの名前と同じです。先のセクションにあるとおり、リソース ファイルのリソースはクラスのプロパティとして公開されます。

処理手順

My.Resources オブジェクトに関連するタスクの例を次の表に示します。

目的	参照項目
文字列リソースを取得する	方法 : Visual Basic で文字列リソースを取得する
イメージ リソースを取得する	方法 : Visual Basic でイメージ リソースを取得する
アイコン リソースを取得する	方法 : Visual Basic でアイコン リソースを取得する
オーディオ リソースを取得する	方法 : Visual Basic でオーディオ リソースを取得する
ローカライズされたリソースを取得する	方法 : Visual Basic で、ローカライズされたリソースを取得する

使用例

次の例は、アプリケーションのリソース ファイルに格納された Form1Icon という名前のアイコンを、フォームのアイコンに設定します。

Sub SetFormIcon()
    Me.Icon = My.Resources.Form1Icon
End Sub

この例を実行するには、アプリケーションのリソース ファイルに Form1Icon という名前のアイコンが格納されている必要があります。詳細については、「方法 : リソースを追加または削除する」を参照してください。

参照

処理手順

方法 : Visual Basic で文字列リソースを取得する

方法 : Visual Basic でイメージ リソースを取得する

方法 : Visual Basic でアイコン リソースを取得する

方法 : Visual Basic でオーディオ リソースを取得する

方法 : Visual Basic で、ローカライズされたリソースを取得する

方法 : リソースを追加または削除する

チュートリアル : Windows フォームのローカリゼーション

概念

アプリケーションのリソース

参照

My.Application.UICulture プロパティ

その他の技術情報

アプリケーション リソースの管理