共用方式為


Audio.Play 方法

定義

播放 .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 包含聲音檔的名稱。

例外狀況

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

參數

data
Byte[]

Byte 陣列,表示音效檔。

playMode
AudioPlayMode

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

例外狀況

dataNothing

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

參數

stream
Stream

Stream,表示音效檔。

playMode
AudioPlayMode

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

例外狀況

streamNothing

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 -> unit
Public 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 服務
網站

另請參閱

適用於