SoundPlayer.Play Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
Die beim Ladevorgang verstrichene Zeit übersteigt die vom LoadTimeout angegebene Zeitspanne (in Millisekunden).
Die durch SoundLocation angegebene Datei kann nicht gefunden werden.
Der WAV-Header ist fehlerhaft; die durch die SoundLocation angegebene Datei ist keine PCM-WAV-Datei.
Beispiele
Das folgende Codebeispiel veranschaulicht die Verwendung der Play -Methode zum asynchronen Wiedergeben einer .wav-Datei. 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 ab. 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 - oder Load -Methode verwenden, um die .wav-Datei im Voraus in den Arbeitsspeicher zu laden. Nachdem eine .wav Datei erfolgreich aus einer Stream ODER URL geladen wurde, müssen zukünftige Aufrufe von Wiedergabemethoden für die SoundPlayer die .wav-Datei erst erneut geladen werden, 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.