SoundPlayer.LoadAsync SoundPlayer.LoadAsync SoundPlayer.LoadAsync SoundPlayer.LoadAsync Method

定義

新しいスレッドを使用して、ストリームまたは Web リソースから .wav ファイルを読み込みます。Loads a .wav file from a stream or a Web resource using a new thread.

public:
 void LoadAsync();
public void LoadAsync ();
member this.LoadAsync : unit -> unit
Public Sub LoadAsync ()

例外

読み込み時の経過時間が、LoadTimeout で指定された時間 (ミリ秒単位) を超過しました。The elapsed time during loading exceeds the time, in milliseconds, specified by LoadTimeout.

SoundLocation で指定したファイルが見つかりません。The file specified by SoundLocation cannot be found.

次のコード例は、の使用を示します、LoadAsyncのインスタンスで使用するための .wav ファイルを非同期的に読み込む方法、SoundPlayerクラス。The following code example demonstrates the use of the LoadAsync method to asynchronously load a .wav file for use by an instance of the SoundPlayer class. このコード例が示されている例の一部、SoundPlayerクラス。This code example is part of a larger example provided for the SoundPlayer class.

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から .wav ファイルを読み込むように構成されて、Streamまたは Web リソースでは、このメソッドは新しいスレッドを使用してその場所からの .wav ファイルの読み込み開始します。If a SoundPlayer is configured to load a .wav file from a Stream or Web resource, this method begins loading a .wav file from the location using a new thread.

このメソッドはLoadCompletedを読み込むときにイベントが完了したら、負荷が失敗した場合でもです。This method raises the LoadCompleted event when loading completes, even if the load was not successful.

場合、SoundPlayerが構成されているローカル ファイル パスから .wav ファイルの読み込み、このメソッドは何も、再生が開始されるまで遅延すると、読み込みのためです。If a SoundPlayer is configured to load a .wav file from a local file path, this method does nothing, because loading is deferred until playing begins.

非同期読み込みの詳細については、次を参照してください。方法。サウンドを Windows フォーム内で非同期的に読み込むします。For more information about asynchronous loading, see How to: Load a Sound Asynchronously within a Windows Form.

適用対象

こちらもご覧ください