SoundPlayer.LoadAsync Methode

Definition

Namespace:
System.Media
Assembly:
System.dll

Lädt eine .wav Datei aus einem Stream oder einer Webressource mithilfe eines neuen Threads.

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

Ausnahmen

TimeoutException

Die verstrichene Zeit während des Ladevorgangs überschreitet die Zeit in Millisekunden, die durch LoadTimeout.

FileNotFoundException

Die angegebene SoundLocation Datei wurde nicht gefunden.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der LoadAsync Methode zum asynchronen Laden einer .wav Datei für die Verwendung durch eine Instanz der SoundPlayer Klasse. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SoundPlayer Klasse bereitgestellt wird.

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

Hinweise

Wenn eine SoundPlayer konfiguriert ist, um eine .wav Datei aus einer Stream oder Webressource zu laden, beginnt diese Methode mit dem Laden einer .wav Datei vom Speicherort mithilfe eines neuen Threads.

Diese Methode löst das Ereignis aus, wenn das LoadCompleted Laden abgeschlossen ist, auch wenn die Ladevorgang nicht erfolgreich war.

Wenn eine SoundPlayer Datei so konfiguriert ist, dass eine .wav Datei aus einem lokalen Dateipfad geladen wird, führt diese Methode nichts aus, da das Laden verzögert wird, bis die Wiedergabe beginnt.

Weitere Informationen zum asynchronen Laden finden Sie unter How to: Load a Sound asynchron within a Windows Form.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Load().

Gilt für:

Weitere Informationen