次の方法で共有


My.Resources オブジェクト (Visual Basic)

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

解説

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

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

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

プロパティ

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

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

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

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

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

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

カテゴリ

プロパティのデータ型

文字列

文字列

イメージ

Bitmap

[アイコン]

Icon

オーディオ

UnmanagedMemoryStream

UnmanagedMemoryStream クラスは Stream クラスから派生しているため、ストリームを受け取るメソッド (Play メソッドなど) で使用できます。

Files

  • テキスト ファイルの場合は String

  • イメージ ファイルの場合は 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 フォームのローカリゼーション

概念

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

その他の技術情報

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