My.Computer.Audio.Play 方法

發行項
08/21/2008

更新：2007 年 11 月

播放 .wav 音效檔。

 ' Usage My.Computer.Audio.Play(location) My.Computer.Audio.Play(location ,playMode) My.Computer.Audio.Play(data ,playMode) My.Computer.Audio.Play(stream ,playMode) ' Declaration Public Sub Play( _    ByVal location As String _ ) ' -or- Public Sub Play( _    ByVal location As String, _    ByVal playMode As AudioPlayMode _ ) ' -or- Public Sub Play( _    ByVal data As Byte(), _    ByVal playMode As AudioPlayMode _ ) ' -or- Public Sub Play( _    ByVal stream As System.IO.Stream, _    ByVal playMode As AudioPlayMode _ )

參數

location
包含音效檔名稱的 String。
data
代表音效檔的 Byte 陣列。
stream
代表音效檔的 Stream。
playMode
用於播放音效的 AudioPlayMode 列舉型別模式。預設為 AudioPlayMode.Background。

例外狀況

下列條件可能造成例外狀況：

data 或 stream 為 Nothing，或者 location 為空字串 (ArgumentNullException)。
playMode 引數不是其中一個 AudioPlayMode 列舉型別值 (InvalidEnumArgumentException)。
使用者沒有足夠的使用權限可以存取由 location 命名的檔案 (IOException)。
location 中的檔案路徑錯誤 (DirectoryNotFoundException)。
location 中的路徑名稱太長 (PathTooLongException)。
發生使用者缺少必要權限的部分信任狀況 (SecurityException)。

備註

Play 方法會播放在 location 儲存為檔案、在 data 中儲存為位元組陣列，或在 stream 中儲存為資料流的 .wav 音效檔。

如果使用了僅採用 location 參數的多載，則 Play 方法會在背景 (Background) 播放音效。否則，將由 playMode 參數決定音效的播放方式。

playMode	描述
AudioPlayMode.Background	在背景播放音效。呼叫程式碼則繼續執行。
AudioPlayMode.BackgroundLoop	在背景播放音效，直到呼叫 My.Computer.Audio.Stop 方法為止。呼叫程式碼則繼續執行。
AudioPlayMode.WaitToComplete	播放音效並等到播放完成，呼叫程式碼才會繼續執行。

背景播放方式可讓應用程式於播放音效時執行其他程式碼。如需詳細資訊，請參閱 HOW TO：在 Visual Basic 中播放重複循環音效和 HOW TO：在 Visual Basic 中播放音效。

工作

下表列出包含 My.Computer.Audio.Play 方法的工作範例。

若要	請參閱
播放一次音效	HOW TO：在 Visual Basic 中播放音效並且等候播放完畢
播放多次音效	HOW TO：在 Visual Basic 中播放重複循環音效
在背景播放音效	HOW TO：在 Visual Basic 中播放音效

範例

指定 PlayMode.Background 時，My.Computer.Audio.Play 方法會在背景播放指定的音效。

Sub PlayBackgroundSoundFile()
    My.Computer.Audio.Play("C:\Waterfall.wav", _
        AudioPlayMode.Background)
End Sub

這個程式碼範例只能在 Windows Form 應用程式內執行。

檔案名稱應該要參考電腦上的 .wav 音效檔。

若要簡化音效檔的管理，請考慮將檔案儲存為應用程式資源。然後可以透過 My.Resources 物件存取它們。

需求

命名空間：Microsoft.VisualBasic.Devices

類別︰Audio

組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型	是否可用
Windows 應用程式	是
類別庫	是
主控台應用程式	是
Windows 控制項程式庫	是
Web 控制項程式庫	否
Windows 服務	是
網站	否

使用權限

下列使用權限可能為必要：

使用權限	描述
FileIOPermission	控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。
SecurityPermission	描述套用至程式碼的一組安全性權限。關聯的列舉型別：ControlThread。