SoundPlayer.LoadAsync Metoda

Definicja

Przestrzeń nazw:

System.Media

Zestaw:

System.Windows.Extensions.dll

Pakiet:

System.Windows.Extensions v8.0.0

Źródło:

SoundPlayer.cs

Ładuje plik wav ze strumienia lub zasobu sieci Web przy użyciu nowego wątku.

public:
 void LoadAsync();

public void LoadAsync ();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

Wyjątki

TimeoutException

Czas, który upłynął podczas ładowania, przekracza czas określony w milisekundach określonych przez LoadTimeout.

FileNotFoundException

Nie można odnaleźć pliku określonego przez SoundLocation program .

Przykłady

Poniższy przykład kodu przedstawia użycie LoadAsync metody do asynchronicznego ładowania pliku wav do użycia przez wystąpienie SoundPlayer klasy. Ten przykład kodu jest częścią większego przykładu podanego SoundPlayer dla klasy.

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 element SoundPlayer jest skonfigurowany do załadowania pliku wav z zasobu internetowego Stream lub lub, ta metoda rozpoczyna ładowanie pliku wav z lokalizacji przy użyciu nowego wątku.

Ta metoda zgłasza zdarzenie po zakończeniu LoadCompleted ładowania, nawet jeśli obciążenie nie powiodło się.

Jeśli element SoundPlayer jest skonfigurowany do załadowania pliku wav ze ścieżki pliku lokalnego, ta metoda nie wykonuje żadnych czynności, ponieważ ładowanie jest odroczone do momentu rozpoczęcia odtwarzania.

Aby uzyskać więcej informacji na temat ładowania asynchronicznego, zobacz Instrukcje: ładowanie dźwięku asynchronicznie w formularzu systemu Windows.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Load()usługę .

Zobacz też

• Load()
• LoadCompleted
• Omówienie klasy SoundPlayer (Windows Forms)
• Instrukcje: ładowanie dźwięku asynchronicznie w formularzu systemu Windows