SoundPlayer.LoadAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
新しいスレッドを使用して、ストリームまたは Web リソースから.wav ファイルを読み込みます。
public:
void LoadAsync();
public void LoadAsync();
member this.LoadAsync : unit -> unit
Public Sub LoadAsync ()
例外
読み込み中の経過時間が、 LoadTimeoutで指定された時間 (ミリ秒単位) を超えています。
SoundLocationで指定されたファイルが見つかりません。
例
次のコード例では、 LoadAsync メソッドを使用して、 SoundPlayer クラスのインスタンスで使用する.wav ファイルを非同期的に読み込む方法を示します。 このコード例は、 SoundPlayer クラスに提供されるより大きな例の一部です。
try
{
// Assign the selected file's path to
// the SoundPlayer object.
player->SoundLocation = this->filepathTextbox->Text;
// Load the .wav file.
player->LoadAsync();
}
catch ( Exception^ ex )
{
ReportStatus( ex->Message );
}
try
{
// Assign the selected file's path to
// the SoundPlayer object.
player.SoundLocation = this.filepathTextbox.Text;
// Load the .wav file.
player.LoadAsync();
}
catch (Exception ex)
{
ReportStatus(ex.Message);
}
Try
' Assign the selected file's path to the SoundPlayer object.
player.SoundLocation = Me.filepathTextbox.Text
' Load the .wav file.
player.LoadAsync()
Catch ex As Exception
ReportStatus(ex.Message)
End Try
注釈
Streamまたは Web リソースから.wav ファイルを読み込むようSoundPlayerが構成されている場合、このメソッドは新しいスレッドを使用して場所から.wav ファイルの読み込みを開始します。
このメソッドは、読み込みが成功しなかった場合でも、読み込みが完了したときに LoadCompleted イベントを発生させます。
SoundPlayerがローカル ファイル パスから.wav ファイルを読み込むよう構成されている場合、読み込みは再生が開始されるまで遅延されるため、このメソッドは何も行いません。
非同期読み込みの詳細については、「方法: Windows フォーム内でサウンドを非同期的に読み込むを参照してください。
このメソッドは、メソッドの同期的な例外がスローできるすべての非使用例外を返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機しているときにスローされます。 ArgumentException などの使用に関する例外は、引き続き同期的にスローされます。 格納されている例外については、 Load()によってスローされる例外を参照してください。
適用対象
こちらもご覧ください
- Load()
- LoadCompleted
- SoundPlayer クラスの概要 (Windows フォーム)
- 方法: Windows フォーム 内でサウンドを非同期的に読み込む