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)