共用方式為

Audio.Play 方法

  • 參考

定義

命名空間:
Microsoft.VisualBasic.Devices
組件:
Microsoft.VisualBasic.dll
組件:
Microsoft.VisualBasic.Forms.dll

播放 .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 -> unit
Public Sub Play (location As String)

參數

location
String

， String 包含聲音檔的名稱。

例外狀況

ArgumentNullException

location 為空字串。

IOException

使用者沒有足夠的使用權限可以存取由 location 命名的檔案。

DirectoryNotFoundException

檔案路徑在 location 中的格式不正確。

PathTooLongException

location 中的路徑名稱太長。

SecurityException

發生使用者缺少必要權限的部分信任狀況。

範例

當 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 -> unit
Public Sub Play (data As Byte(), playMode As AudioPlayMode)

參數

data
Byte[]

Byte 陣列，表示音效檔。

playMode
AudioPlayMode

用於播放音效的 AudioPlayMode模式。 預設值為 AudioPlayMode.Background。

例外狀況

ArgumentNullException

data 為 Nothing。

InvalidEnumArgumentException

playMode 不是其中一個 AudioPlayMode 列舉值。

SecurityException

發生使用者缺少必要權限的部分信任狀況。

範例

當 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 -> unit
Public Sub Play (stream As Stream, playMode As AudioPlayMode)

參數

stream
Stream

Stream，表示音效檔。

playMode
AudioPlayMode

用於播放音效的 AudioPlayMode模式。 預設值為 AudioPlayMode.Background。

例外狀況

ArgumentNullException

stream 為 Nothing。

InvalidEnumArgumentException

playMode 不是其中一個 AudioPlayMode 列舉值。

SecurityException

發生使用者缺少必要權限的部分信任狀況。

範例

當 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 -> unit
Public Sub Play (location As String, playMode As AudioPlayMode)

參數

location
String

， String 包含聲音檔的名稱。

playMode
AudioPlayMode

用於播放音效的 AudioPlayMode模式。 預設值為 AudioPlayMode.Background。

例外狀況

ArgumentNullException

location 為空字串。

IOException

使用者沒有足夠的使用權限可以存取由 location 命名的檔案。

DirectoryNotFoundException

檔案路徑在 location 中的格式不正確。

PathTooLongException

location 中的路徑名稱太長。

InvalidEnumArgumentException

playMode 不是其中一個 AudioPlayMode 列舉值。

SecurityException

發生使用者缺少必要權限的部分信任狀況。

範例

當指定 時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 服務 是
網站 否

另請參閱

適用於