SoundPlayer.PlaySync Metódus

Definíció

Névtér:

System.Media

Szerelvény:

System.Windows.Extensions.dll

Csomag:

System.Windows.Extensions v11.0.0-rc.1.26425.128

Forrás:

SoundPlayer.cs

Lejátssza a .wav fájlt, és betölti először a .wav fájlt, ha nincs betöltve.

public:
 void PlaySync();

public void PlaySync();

member this.PlaySync : unit -> unit

Public Sub PlaySync ()

Kivételek

TimeoutException

A betöltés során eltelt idő meghaladja a megadott időt ezredmásodpercben.LoadTimeout

FileNotFoundException

A megadott SoundLocation fájl nem található.

InvalidOperationException

A .wav fejléc sérült; a megadott SoundLocation fájl nem PCM .wav fájl.

Példák

Az alábbi példakód azt mutatja be, hogy a PlaySync metódus szinkron módon játszik le egy .wav fájlt.

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)
      {
         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

Megjegyzések

A PlaySync metódus az aktuális szálat használja egy .wav fájl lejátszásához, megakadályozva, hogy a szál más üzeneteket kezeljen a terhelés befejezéséig. A .wav fájl előre betölthető LoadAsyncLoad a memóriába. Miután egy .wav fájl sikeresen betöltődött egy Stream VAGY URL-címről, a SoundPlayer lejátszási metódusok jövőbeli hívásainak nem kell újra betöltenie a .wav fájlt, amíg meg nem változik a hang elérési útja.

Ha a .wav fájl nincs megadva, vagy nem töltődik be, a PlaySync metódus az alapértelmezett hangjelzést fogja lejátszani.

Lásd még

• Play()
• PlayLooping()
• SoundPlayer osztály áttekintése (Windows Forms)