SoundPlayer.Play Methode

Definition

Namespace:

System.Media

Assembly:

System.Windows.Extensions.dll

Paket:

System.Windows.Extensions v8.0.0

Quelle:

SoundPlayer.cs

Lädt zunächst die WAV-Datei, sofern sie nicht bereits geladen ist, und gibt sie mithilfe eines neuen Threads wieder.

public:
 void Play();

public void Play ();

member this.Play : unit -> unit

Public Sub Play ()

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.

InvalidOperationException

Der WAV-Header ist fehlerhaft; die durch die SoundLocation angegebene Datei ist keine PCM-WAV-Datei.

Beispiele

Im folgenden Codebeispiel wird die Verwendung der Play -Methode zum asynchronen Wiedergeben einer WAV-Datei veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SoundPlayer-Klasse bereitgestellt wird.

ReportStatus( "Playing .wav file asynchronously." );
player->Play();

ReportStatus("Playing .wav file asynchronously.");
player.Play();

ReportStatus("Playing .wav file asynchronously.")
player.Play()

Hinweise

Die Play -Methode gibt den Sound mithilfe eines neuen Threads wieder. Wenn Sie aufrufen Play , bevor die WAV-Datei in den Arbeitsspeicher geladen wurde, wird die WAV-Datei geladen, bevor die Wiedergabe beginnt. Sie können die LoadAsync -Methode oder Load verwenden, um die WAV-Datei im Voraus in den Arbeitsspeicher zu laden. Nachdem eine WAV-Datei erfolgreich aus einer - oder - Stream URL geladen wurde, müssen zukünftige Aufrufe von Wiedergabemethoden für die SoundPlayer die WAV-Datei erst neu laden, wenn sich der Pfad für den Sound ändert.

Wenn die WAV-Datei nicht angegeben wurde oder nicht geladen werden kann, gibt die Play Methode den Standardtonton ab.

Weitere Informationen

• PlayLooping()
• PlaySync()
• Übersicht über die SoundPlayer-Klasse (Windows Forms)