次の方法で共有


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 プロパティ

その他の技術情報

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