My.Computer.Audio.Play 方法

更新：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 方法播放 .wav 声音文件，该文件共有三种形式，存储在 location 中为文件，存储在 data 中为字节数组，存储在 stream 中为流。

如果使用的重载只带 location 参数，则 Play 方法将在后台播放声音。否则，由 playMode 参数确定声音的播放方式。

后台播放使得应用程序可以在播放声音时执行其他代码。有关更多信息，请参见如何：在 Visual Basic 中播放循环声音和如何：在 Visual Basic 中播放声音。

任务

下表列出了涉及 My.Computer.Audio.Play 方法的任务示例。

示例

指定 PlayMode.Background 时，My.Computer.Audio.Play 方法在后台播放指定声音。

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

此代码示例只能在 Windows 窗体应用程序中运行。

文件名应引用系统上的 .wav 声音文件。

若要简化声音文件的管理，请考虑将这些文件存储为应用程序资源。之后，就能通过 My.Resources 对象访问它们。

要求

命名空间：Microsoft.VisualBasic.Devices

类：Audio

**程序集：**Visual Basic Runtime Library（位于 Microsoft.VisualBasic.dll 中）

按项目类型列出可用性

权限

以下权限可能是必需的：

有关更多信息，请参见代码访问安全性和请求权限。

请参见

任务

如何：在 Visual Basic 中播放声音并等待完成

如何：在 Visual Basic 中播放循环声音

如何：在 Visual Basic 中播放声音

参考

My.Computer.Audio 对象

My.Computer.Audio.Stop 方法

AudioPlayMode 枚举

System.IO.Stream

Audio.Play