Audio.Play 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
播放 .wav 音效檔。
多載
| Play(String) |
播放 .wav 音效檔。 |
| Play(Byte[], AudioPlayMode) |
播放 .wav 音效檔。 |
| Play(Stream, AudioPlayMode) |
播放 .wav 音效檔。 |
| Play(String, AudioPlayMode) |
播放 .wav 音效檔。 |
Play(String)
播放 .wav 音效檔。
public:
void Play(System::String ^ location);public void Play (string location);member this.Play : string -> unitPublic Sub Play (location As String)參數
- location
- String
， String 包含聲音檔的名稱。
例外狀況
location 為空字串。
使用者沒有足夠的使用權限可以存取由 location 命名的檔案。
檔案路徑在 location 中的格式不正確。
location 中的路徑名稱太長。
發生使用者缺少必要權限的部分信任狀況。
範例
當 My.Computer.Audio.Play 指定時 PlayMode.Background ，方法會在背景播放指定的音效。
Sub PlayBackgroundSoundFile()
My.Computer.Audio.Play("C:\Waterfall.wav",
AudioPlayMode.WaitToComplete)
End Sub
此程式代碼範例只能在 Windows Forms 應用程式中執行。
檔名應該會參考系統上的.wav音效檔案。
若要簡化聲音檔案的管理，請考慮將檔案儲存為應用程式資源。 然後可以透過 My.Resources 物件存取它們。
備註
方法 Play 會播放儲存為 檔案的.wav聲音檔案，做為 location中的 data位元組陣列，或作為中的 stream數據流。
如果使用只採用 參數的多 location 載，則 Play 方法會在背景播放音效。 否則， playMode 參數會決定音效的播放方式。
playMode |
描述 |
|---|---|
AudioPlayMode.Background |
在背景播放音效。 呼叫程式碼會繼續執行。 |
AudioPlayMode.BackgroundLoop |
在背景播放音效，直到 Stop 呼叫 方法為止。 呼叫程式碼會繼續執行。 |
AudioPlayMode.WaitToComplete |
播放音效，並等到呼叫程式代碼繼續之前完成。 |
背景播放可讓應用程式在播放音效時執行其他程式碼。
如需詳細資訊，請參閱播放音效。
依專案類型的可用性
| 專案類型 | 可用 |
|---|---|
| Windows 應用程式 | 是 |
| 類別庫 | 是 |
| 主控台應用程式 | 是 |
| Windows 控制項程式庫 | 是 |
| Web 控制項程式庫 | 否 |
| Windows 服務 | 是 |
| 網站 | 否 |
另請參閱
適用於
Play(Byte[], AudioPlayMode)
播放 .wav 音效檔。
public:
void Play(cli::array <System::Byte> ^ data, Microsoft::VisualBasic::AudioPlayMode playMode);public void Play (byte[] data, Microsoft.VisualBasic.AudioPlayMode playMode);member this.Play : byte[] * Microsoft.VisualBasic.AudioPlayMode -> unitPublic Sub Play (data As Byte(), playMode As AudioPlayMode)參數
- data
- Byte[]
Byte 陣列，表示音效檔。
- playMode
- AudioPlayMode
用於播放音效的 AudioPlayMode模式。 預設值為 AudioPlayMode.Background。
例外狀況
data 為 Nothing。
playMode 不是其中一個 AudioPlayMode 列舉值。
發生使用者缺少必要權限的部分信任狀況。
範例
當 My.Computer.Audio.Play 指定時 PlayMode.Background ，方法會在背景播放指定的音效。
Sub PlayBackgroundSoundFile()
My.Computer.Audio.Play("C:\Waterfall.wav",
AudioPlayMode.WaitToComplete)
End Sub
此程式代碼範例只能在 Windows Forms 應用程式中執行。
檔名應該會參考系統上的.wav音效檔案。
若要簡化聲音檔案的管理，請考慮將檔案儲存為應用程式資源。 然後可以透過 My.Resources 物件存取它們。
備註
方法 Play 會播放儲存為 檔案的.wav聲音檔案，做為 location中的 data位元組陣列，或作為中的 stream數據流。
如果使用只採用 參數的多 location 載，則 Play 方法會在背景播放音效。 否則， playMode 參數會決定音效的播放方式。
playMode |
描述 |
|---|---|
AudioPlayMode.Background |
在背景播放音效。 呼叫程式碼會繼續執行。 |
AudioPlayMode.BackgroundLoop |
在背景播放音效，直到 Stop 呼叫 方法為止。 呼叫程式碼會繼續執行。 |
AudioPlayMode.WaitToComplete |
播放音效，並等到呼叫程式代碼繼續之前完成。 |
背景播放可讓應用程式在播放音效時執行其他程式碼。
如需詳細資訊，請參閱播放音效。
依專案類型的可用性
| 專案類型 | 可用 |
|---|---|
| Windows 應用程式 | 是 |
| 類別庫 | 是 |
| 主控台應用程式 | 是 |
| Windows 控制項程式庫 | 是 |
| Web 控制項程式庫 | 否 |
| Windows 服務 | 是 |
| 網站 | 否 |
另請參閱
適用於
Play(Stream, AudioPlayMode)
播放 .wav 音效檔。
public:
void Play(System::IO::Stream ^ stream, Microsoft::VisualBasic::AudioPlayMode playMode);public void Play (System.IO.Stream stream, Microsoft.VisualBasic.AudioPlayMode playMode);member this.Play : System.IO.Stream * Microsoft.VisualBasic.AudioPlayMode -> unitPublic Sub Play (stream As Stream, playMode As AudioPlayMode)參數
- playMode
- AudioPlayMode
用於播放音效的 AudioPlayMode模式。 預設值為 AudioPlayMode.Background。
例外狀況
stream 為 Nothing。
playMode 不是其中一個 AudioPlayMode 列舉值。
發生使用者缺少必要權限的部分信任狀況。
範例
當 My.Computer.Audio.Play 指定時 PlayMode.Background ，方法會在背景播放指定的音效。
Sub PlayBackgroundSoundFile()
My.Computer.Audio.Play("C:\Waterfall.wav",
AudioPlayMode.WaitToComplete)
End Sub
此程式代碼範例只能在 Windows Forms 應用程式中執行。
檔名應該會參考系統上的.wav音效檔案。
若要簡化聲音檔案的管理，請考慮將檔案儲存為應用程式資源。 然後可以透過 My.Resources 物件存取它們。
備註
方法 Play 會播放儲存為 檔案 location的.wav聲音檔，做為 中的 data位元組陣列，或中的 stream數據流。
如果使用只 location 接受 參數的多載，方法 Play 會在背景播放音效。 否則， playMode 參數會決定音效的播放方式。
playMode |
描述 |
|---|---|
AudioPlayMode.Background |
在背景播放音效。 呼叫程式碼會繼續執行。 |
AudioPlayMode.BackgroundLoop |
在背景播放音效，直到 Stop 呼叫 方法為止。 呼叫程式碼會繼續執行。 |
AudioPlayMode.WaitToComplete |
播放音效，並等候它完成，再繼續呼叫程序代碼。 |
背景播放可讓應用程式在播放音效時執行其他程式碼。
如需詳細資訊，請參閱播放音效。
依專案類型的可用性
| 專案類型 | 可用 |
|---|---|
| Windows 應用程式 | 是 |
| 類別庫 | 是 |
| 主控台應用程式 | 是 |
| Windows 控制項程式庫 | 是 |
| Web 控制項程式庫 | 否 |
| Windows 服務 | 是 |
| 網站 | 否 |
另請參閱
適用於
Play(String, AudioPlayMode)
播放 .wav 音效檔。
public:
void Play(System::String ^ location, Microsoft::VisualBasic::AudioPlayMode playMode);public void Play (string location, Microsoft.VisualBasic.AudioPlayMode playMode);member this.Play : string * Microsoft.VisualBasic.AudioPlayMode -> unitPublic Sub Play (location As String, playMode As AudioPlayMode)參數
- location
- String
， String 包含聲音檔的名稱。
- playMode
- AudioPlayMode
用於播放音效的 AudioPlayMode模式。 預設值為 AudioPlayMode.Background。
例外狀況
location 為空字串。
使用者沒有足夠的使用權限可以存取由 location 命名的檔案。
檔案路徑在 location 中的格式不正確。
location 中的路徑名稱太長。
playMode 不是其中一個 AudioPlayMode 列舉值。
發生使用者缺少必要權限的部分信任狀況。
範例
當指定 時PlayMode.Background，方法My.Computer.Audio.Play會在背景播放指定的音效。
Sub PlayBackgroundSoundFile()
My.Computer.Audio.Play("C:\Waterfall.wav",
AudioPlayMode.WaitToComplete)
End Sub
此程式代碼範例只能在 Windows Forms 應用程式中執行。
檔名應該參考系統上.wav聲音檔。
若要簡化聲音檔的管理，請考慮將檔案儲存為應用程式資源。 然後可以透過 My.Resources 物件存取它們。
備註
方法 Play 會播放儲存為 檔案 location的.wav聲音檔，做為 中的 data位元組陣列，或中的 stream數據流。
如果使用只 location 接受 參數的多載，方法 Play 會在背景播放音效。 否則， playMode 參數會決定音效的播放方式。
playMode |
描述 |
|---|---|
AudioPlayMode.Background |
在背景播放音效。 呼叫程式碼會繼續執行。 |
AudioPlayMode.BackgroundLoop |
在背景播放音效，直到 Stop 呼叫 方法為止。 呼叫程式碼會繼續執行。 |
AudioPlayMode.WaitToComplete |
播放音效，並等候它完成，再繼續呼叫程序代碼。 |
背景播放可讓應用程式在播放音效時執行其他程式碼。
如需詳細資訊，請參閱播放音效。
依專案類型的可用性
| 專案類型 | 可用 |
|---|---|
| Windows 應用程式 | 是 |
| 類別庫 | 是 |
| 主控台應用程式 | 是 |
| Windows 控制項程式庫 | 是 |
| Web 控制項程式庫 | 否 |
| Windows 服務 | 是 |
| 網站 | 否 |
另請參閱
適用於
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應