Freigeben über


SoundPlayer.PlaySync Methode

Definition

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

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

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 PlaySync -Methode zum synchronen Wiedergeben einer .wav-Datei.

private:
   SoundPlayer^ Player;

   void loadSoundAsync()
   {
      // Note: You may need to change the location specified based on
      // the location of the sound to be played.
      this->Player->SoundLocation = "http://www.tailspintoys.com/sounds/stop.wav";
      this->Player->LoadAsync();
   }

   void Player_LoadCompleted( Object^ /*sender*/, System::ComponentModel::AsyncCompletedEventArgs^ /*e*/ )
   {
      if (this->Player->IsLoadCompleted == true)
      {
         this->Player->PlaySync();
      }
   }
private SoundPlayer Player = new SoundPlayer();
private void loadSoundAsync()
{
    // Note: You may need to change the location specified based on
    // the location of the sound to be played.
    this.Player.SoundLocation = "http://www.tailspintoys.com/sounds/stop.wav";
    this.Player.LoadAsync();
}

private void Player_LoadCompleted (
    object sender, 
    System.ComponentModel.AsyncCompletedEventArgs e)
{
    if (this.Player.IsLoadCompleted)
    {
        this.Player.PlaySync();
    }
}
Private WithEvents Player As New SoundPlayer

Sub LoadSoundAsync()
    ' Note: You may need to change the location specified based on
    ' the location of the sound to be played.
    Me.Player.SoundLocation = "http://www.tailspintoys.com/sounds/stop.wav"
    Me.Player.LoadAsync ()
End Sub

Private Sub PlayWhenLoaded(ByVal sender As Object, ByVal e As _
    System.ComponentModel.AsyncCompletedEventArgs) Handles _
    Player.LoadCompleted
    If Me.Player.IsLoadCompleted = True Then
            Me.Player.PlaySync()
    End If
End Sub

Hinweise

Die PlaySync -Methode verwendet den aktuellen Thread, um eine .wav-Datei wiederzugeben, wodurch verhindert wird, dass der Thread andere Nachrichten verarbeitet, bis die Ladevorgang abgeschlossen ist. 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 PlaySync Methode den Standardtonton ab.

Gilt für:

Weitere Informationen