SoundPlayer::LoadAsync Method ()

 

Loads a .wav file from a stream or a Web resource using a new thread.

Namespace:   System.Media
Assembly:  System (in System.dll)

public:
void LoadAsync()

Exception Condition
TimeoutException

The elapsed time during loading exceeds the time, in milliseconds, specified by LoadTimeout.

FileNotFoundException

The file specified by SoundLocation cannot be found.

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.

This method raises the LoadCompleted event when loading completes, even if the load was not successful.

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.

For more information about asynchronous loading, see How to: Load a Sound Asynchronously within a Windows Form.

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. 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 );
}


.NET Framework
Available since 2.0
Return to top
Show: