SoundPlayer.Play 方法

定義

命名空間:

System.Media

組件:

System.Windows.Extensions.dll

套件:

System.Windows.Extensions v8.0.0

來源:

SoundPlayer.cs

使用新執行緒播放 .wav 檔，如果 .wav 檔還未載入則先將其載入。

public:
 void Play();

public void Play ();

member this.Play : unit -> unit

Public Sub Play ()

例外狀況

TimeoutException

載入時耗用的時間超過了 LoadTimeout 所指定的時間 (以毫秒為單位)。

FileNotFoundException

找不到 SoundLocation 指定的檔案。

InvalidOperationException

.wav 標頭損毀，SoundLocation 指定的檔案不是 PCM .wav 檔。

範例

下列程式碼範例示範如何使用 Play 方法來非同步播放 .wav 檔案。 此程式碼範例是提供給 類別之較大範例的 SoundPlayer 一部分。

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

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

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

備註

方法會 Play 使用新的執行緒播放音效。 如果您在將 .wav 檔案載入記憶體之前呼叫 Play ，則會在播放開始之前載入 .wav 檔案。 您可以使用 LoadAsync 或 Load 方法來事先將 .wav 檔案載入記憶體。 從 Stream 或 URL 成功載入 .wav 檔案之後，未來對 的播放方法 SoundPlayer 呼叫就不需要重載 .wav 檔案，直到音效的路徑變更為止。

如果尚未指定 .wav 檔案或無法載入，方法 Play 會播放預設的嗶聲音效。

另請參閱

• PlayLooping()
• PlaySync()
• SoundPlayer 類別概觀 (Windows Forms)