SoundPlayer.LoadAsync Methode

Definition

Namespace:

System.Media

Assembly:

System.Windows.Extensions.dll

Paket:

System.Windows.Extensions v8.0.0

Quelle:

SoundPlayer.cs

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

public:
 void LoadAsync();

public void LoadAsync ();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

Ausnahmen

TimeoutException

Die beim Ladevorgang verstrichene Zeit übersteigt die vom LoadTimeout angegebene Zeitspanne (in Millisekunden).

FileNotFoundException

Die durch SoundLocation angegebene Datei kann nicht gefunden werden.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der LoadAsync -Methode zum asynchronen Laden einer WAV-Datei zur Verwendung durch einen instance 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 aus dem Speicherort mit einem neuen Thread.

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

Wenn ein SoundPlayer konfiguriert ist, um eine WAV-Datei aus einem lokalen Dateipfad zu laden, macht diese Methode nichts, da das Laden zurückgestellt wird, bis die Wiedergabe beginnt.

Weitere Informationen zum asynchronen Laden finden Sie unter Vorgehensweise: Laden eines Sound asynchron in ein Windows Form.

Diese Methode speichert in der Aufgabe, die sie alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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. Nutzungsausnahmen, z. B ArgumentException. , werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter die von ausgelösten Load()Ausnahmen.

Weitere Informationen

• Load()
• LoadCompleted
• Übersicht über die SoundPlayer-Klasse (Windows Forms)
• Vorgehensweise: Asynchrones Laden eines Sounds in einem Windows Forms