SoundPlayer.Load メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サウンドを同期的に読み込みます。
public:
void Load();
public void Load();
member this.Load : unit -> unit
Public Sub Load ()
例外
読み込み中の経過時間が、 LoadTimeoutで指定された時間 (ミリ秒単位) を超えています。
SoundLocationで指定されたファイルが見つかりません。
例
次のコード例では、 LoadAsync メソッドを使用して、 SoundPlayer クラスのインスタンスに.wav ファイルをアタッチする方法を示します。 このコード例は、 SoundPlayer クラスに提供されるより大きな例の一部です。
try
{
// Assign the selected file's path to
// the SoundPlayer object.
player->SoundLocation = filepathTextbox->Text;
// Load the .wav file.
player->Load();
}
catch ( Exception^ ex )
{
ReportStatus( ex->Message );
}
try
{
// Assign the selected file's path to
// the SoundPlayer object.
player.SoundLocation = filepathTextbox.Text;
// Load the .wav file.
player.Load();
}
catch (Exception ex)
{
ReportStatus(ex.Message);
}
Try
' Assign the selected file's path to the SoundPlayer object.
player.SoundLocation = filepathTextbox.Text
' Load the .wav file.
player.Load()
Catch ex As Exception
ReportStatus(ex.Message)
End Try
注釈
Load メソッドは、現在のスレッドを使用して.wav ファイルを読み込み、読み込みが完了するまでスレッドが他のメッセージを処理できないようにします。
Caution
Load メソッドでは、大きな.wav ファイルの読み込み中に遅延が発生する可能性があります。 さらに、描画やその他のイベントは、読み込みが完了するまでブロックされます。 LoadAsync メソッドを使用して非同期的にサウンドを読み込みます。これにより、呼び出し元のスレッドを中断せずに続行できます。
このメソッドは、読み込みが成功しなかった場合でも、読み込みが完了したときに LoadCompleted イベントを発生させます。