SoundPlayer.LoadAsync メソッド

定義

名前空間:

System.Media

アセンブリ:

System.Windows.Extensions.dll

パッケージ:

System.Windows.Extensions v8.0.0

ソース:

SoundPlayer.cs

新しいスレッドを使用して、ストリームまたは Web リソースから .wav ファイルを読み込みます。

public:
 void LoadAsync();

public void LoadAsync ();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

例外

TimeoutException

読み込み時の経過時間が、LoadTimeout で指定された時間 (ミリ秒単位) を超過しました。

FileNotFoundException

SoundLocation で指定したファイルが見つかりません。

例

次のコード例では、 メソッドを LoadAsync 使用して、クラスのインスタンスで使用する .wav ファイルを非同期的に読み込む方法を SoundPlayer 示します。 このコード例は、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

注釈

SoundPlayerが または Web リソースから Stream .wav ファイルを読み込むよう構成されている場合、このメソッドは新しいスレッドを使用して場所から .wav ファイルの読み込みを開始します。

このメソッドは、 LoadCompleted 読み込みが成功しなかった場合でも、読み込みが完了したときに イベントを発生させます。

SoundPlayerがローカル ファイル パスから .wav ファイルを読み込むよう構成されている場合、読み込みは再生が開始されるまで遅延されるため、このメソッドは何も行いません。

非同期読み込みの詳細については、「 方法: Windows フォーム内でサウンドを非同期に読み込む」を参照してください。

このメソッドは、メソッドの同期例外がスローできる非使用例外をすべて返すタスクに格納します。 返されたタスクに例外が格納されている場合、その例外はタスクが待機されたときにスローされます。 などの ArgumentException使用例外は、引き続き同期的にスローされます。 格納されている例外については、 によって Load()スローされる例外に関するページを参照してください。

こちらもご覧ください

• Load()
• LoadCompleted
• SoundPlayer クラスの概要 (Windows フォーム)
• 方法: Windows フォーム内でサウンドを非同期的に読み込む