Audio.Play 方法

定義

命名空間:: Microsoft.VisualBasic.Devices

組件:: Microsoft.VisualBasic.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

播放.wav音效檔案。

多載

名稱	Description
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 A 包含音效檔案名稱。

例外狀況

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 方法播放儲存在的 location檔案的 .wav 音效檔案，作為中的 data位元組陣列，或在中的串流 stream播放。

若使用Play僅取參數的location過載，該方法會在背景播放聲音。否則，參數 playMode 決定了聲音的播放方式。

`playMode`	Description
`AudioPlayMode.Background`	背景播放音效。呼叫程式碼繼續執行。
`AudioPlayMode.BackgroundLoop`	在呼叫方法之前 Stop ，會播放背景音效。呼叫程式碼繼續執行。
`AudioPlayMode.WaitToComplete`	播放聲音並等待聲音完成後，呼叫代碼才繼續。

背景播放讓應用程式在聲音播放的同時執行其他程式碼。

更多資訊請參閱「播放聲音」。

依專案類型提供可用性

專案類型	Available
Windows 應用程式	Yes
類別庫	Yes
主控台應用程式	Yes
Windows 控件庫	Yes
Web 控制庫	No
Windows 服務	Yes
網站	No

另請參閱

適用於

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 方法播放儲存在的 location檔案的 .wav 音效檔案，作為中的 data位元組陣列，或在中的串流 stream播放。

若使用Play僅取參數的location過載，該方法會在背景播放聲音。否則，參數 playMode 決定了聲音的播放方式。

`playMode`	Description
`AudioPlayMode.Background`	背景播放音效。呼叫程式碼繼續執行。
`AudioPlayMode.BackgroundLoop`	在呼叫方法之前 Stop ，會播放背景音效。呼叫程式碼繼續執行。
`AudioPlayMode.WaitToComplete`	播放聲音並等待聲音完成後，呼叫代碼才繼續。

背景播放讓應用程式在聲音播放的同時執行其他程式碼。

更多資訊請參閱「播放聲音」。

依專案類型提供可用性

專案類型	Available
Windows 應用程式	Yes
類別庫	Yes
主控台應用程式	Yes
Windows 控件庫	Yes
Web 控制庫	No
Windows 服務	Yes
網站	No

另請參閱

適用於

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播放。

若使用Play僅取參數的location過載，該方法會在背景播放聲音。否則，參數 playMode 決定了聲音的播放方式。

`playMode`	Description
`AudioPlayMode.Background`	背景播放音效。呼叫程式碼繼續執行。
`AudioPlayMode.BackgroundLoop`	在呼叫方法之前 Stop ，會播放背景音效。呼叫程式碼繼續執行。
`AudioPlayMode.WaitToComplete`	播放聲音並等待聲音完成後，呼叫代碼才繼續。

背景播放讓應用程式在聲音播放的同時執行其他程式碼。

更多資訊請參閱「播放聲音」。

依專案類型提供可用性

專案類型	Available
Windows 應用程式	Yes
類別庫	Yes
主控台應用程式	Yes
Windows 控件庫	Yes
Web 控制庫	No
Windows 服務	Yes
網站	No

另請參閱

適用於

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 A 包含音效檔案名稱。

playMode: AudioPlayMode

AudioPlayMode 播放音效的模式。根據預設，AudioPlayMode.Background。

例外狀況

ArgumentNullException

location 是空字串。

IOException

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

DirectoryNotFoundException

檔案路徑在中呈現不當。location

PathTooLongException

裡面 location 的路徑名稱太長了。

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播放。

若使用Play僅取參數的location過載，該方法會在背景播放聲音。否則，參數 playMode 決定了聲音的播放方式。

`playMode`	Description
`AudioPlayMode.Background`	背景播放音效。呼叫程式碼繼續執行。
`AudioPlayMode.BackgroundLoop`	在呼叫方法之前 Stop ，會播放背景音效。呼叫程式碼繼續執行。
`AudioPlayMode.WaitToComplete`	播放聲音並等待聲音完成後，呼叫代碼才繼續。

背景播放讓應用程式在聲音播放的同時執行其他程式碼。

更多資訊請參閱「播放聲音」。

依專案類型提供可用性

專案類型	Available
Windows 應用程式	Yes
類別庫	Yes
主控台應用程式	Yes
Windows 控件庫	Yes
Web 控制庫	No
Windows 服務	Yes
網站	No

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？