SoundPlayer.LoadAsync Metoda

Definicja

Ładuje plik WAV ze strumienia lub zasobu sieci Web przy użyciu nowego wątku.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 ()

Wyjątki

Czas, który upłynął podczas ładowania, przekracza czas (w milisekundach) określony przez LoadTimeout .The elapsed time during loading exceeds the time, in milliseconds, specified by LoadTimeout.

Nie można znaleźć pliku określonego przez SoundLocation .The file specified by SoundLocation cannot be found.

Przykłady

Poniższy przykład kodu demonstruje użycie LoadAsync metody do asynchronicznego ładowania pliku WAV do użycia przez wystąpienie SoundPlayer klasy.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. Ten przykład kodu jest częścią większego przykładu dostarczonego dla SoundPlayer klasy.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

Uwagi

Jeśli SoundPlayer jest skonfigurowany do ładowania pliku WAV z Stream zasobu sieci Web lub, ta metoda rozpoczyna ładowanie pliku WAV z lokalizacji przy użyciu nowego wątku.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.

Ta metoda wywołuje LoadCompleted zdarzenie po zakończeniu ładowania, nawet jeśli ładowanie nie powiodło się.This method raises the LoadCompleted event when loading completes, even if the load was not successful.

Jeśli SoundPlayer jest skonfigurowany do ładowania pliku WAV ze ścieżki do pliku lokalnego, ta metoda nie wykonuje żadnych operacji, ponieważ ładowanie jest odroczone do momentu rozpoczęcia odtwarzania.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.

Aby uzyskać więcej informacji na temat asynchronicznego ładowania, zobacz jak: ładowanie dźwięku asynchronicznie w formularzu systemu Windows.For more information about asynchronous loading, see How to: Load a Sound Asynchronously within a Windows Form.

Dotyczy

Zobacz też