ContentManager.Load ジェネリックメソッド

XNA Game Studio 3.1

Content Pipeline によって処理されたアセットを読み込みます。

名前空間: Microsoft.Xna.Framework.Content
アセンブリ: Microsoft.Xna.Framework (microsoft.xna.framework.dll 内)

構文

public virtual T Load<T> (
         string assetName
)

T: 読み込むアセットの種類。Model、Effect、SpriteFont、Texture、Texture2D、Texture3D および TextureCube はすべて、既定で標準の Content Pipeline プロセッサによってサポートされますが、プロセッサを拡張することによりこれ以外の種類の読み込みが可能になります。

読み込まれるアセット。同じアセットを読み込む呼び出しを繰り返すと、同じオブジェクトインスタンスが返されます。

例外

例外タイプ	条件
ObjectDisposedException	Load が、ContentManager が破棄された後に呼び出されました。
ArgumentNullException	assetName 引数は null です。
ContentLoadException	ファイル内の assetName の種類は、要求されたアセットの種類 (T で指定) と一致しません。

解説

ゲームへのゲームアセットの追加でアセットを読み込む前に、ContentManager で説明した手順を使用してゲームプロジェクトにアセットを追加する必要があります。

以下に示すのは、Load によってサポートされている Content Pipeline ランタイムクラスと、各クラスに関連付けられたファイル形式です。

Effect クラス	.fx
Model クラス	.fbx, .x
SpriteFont クラス	.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm、および .tga ファイル形式をサポートします。注 .bmp ファイルの既定のコンテンツプロセッサはテクスチャープロセッサです。スプライトフォントとして使用するために .bmp ファイルを処理するには、.bmp ファイルをプロジェクトに追加した後で、そのファイルの [プロパティ] ペイン内の [スプライトフォントテクスチャー : XNA Framework] をクリックします。
Texture クラス, Texture2D クラス	.bmp、.dds、.dib、.hdr、.jpg、.pfm、.png、.ppm、および .tga
Texture3D クラス, TextureCube クラス	.dds

これらは元のアセットの形式であることに注意してください。処理後はすべてのアセットが .xnb ファイルになります。

例

ディレクトリ .\content\models\ から "box" というアセット名の Model を読み込むには、以下のようにします。

Model model = contentManager.Load<Model>( ".\\content\\models\\box" );

プラットフォーム

Xbox 360, Windows XP SP2、Windows Vista, Zune