SoundPlayer.LoadAsync メソッド

定義

新しいスレッドを使用して、ストリームまたは 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()によってスローされる例外を参照してください。

適用対象

こちらもご覧ください