Audio.Play 方法

定义

命名空间:: Microsoft.VisualBasic.Devices

程序集:: Microsoft.VisualBasic.dll

程序集:: Microsoft.VisualBasic.Forms.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

播放.wav声音文件。

重载

名称	说明
Play(String)	播放.wav声音文件。
Play(Byte[], AudioPlayMode)	播放.wav声音文件。
Play(Stream, AudioPlayMode)	播放.wav声音文件。
Play(String, AudioPlayMode)	播放.wav声音文件。

Play(String)

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

播放.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 窗体应用程序中运行。

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

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

注解

该方法Play播放存储为文件、字节数组location或流中的data.wav声音文件stream。

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

`playMode`	Description
`AudioPlayMode.Background`	在后台播放声音。调用代码继续执行。
`AudioPlayMode.BackgroundLoop`	在后台播放声音，直到 Stop 调用该方法。调用代码继续执行。
`AudioPlayMode.WaitToComplete`	播放声音并等待它完成，直到调用代码继续。

后台播放允许应用程序在声音播放时执行其他代码。

有关详细信息，请参阅播放声音。

按项目类型提供可用性

项目类型	可用的
Windows 应用程序	Yes
类库	Yes
控制台应用程序	Yes
Windows 控件库	Yes
Web 控件库	否
Windows 服务	Yes
网站	否

另请参阅

适用于

Play(Byte[], AudioPlayMode)

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

播放.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 窗体应用程序中运行。

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

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

注解

该方法Play播放存储为文件、字节数组location或流中的data.wav声音文件stream。

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

`playMode`	Description
`AudioPlayMode.Background`	在后台播放声音。调用代码继续执行。
`AudioPlayMode.BackgroundLoop`	在后台播放声音，直到 Stop 调用该方法。调用代码继续执行。
`AudioPlayMode.WaitToComplete`	播放声音并等待它完成，直到调用代码继续。

后台播放允许应用程序在声音播放时执行其他代码。

有关详细信息，请参阅播放声音。

按项目类型提供可用性

项目类型	可用的
Windows 应用程序	Yes
类库	Yes
控制台应用程序	Yes
Windows 控件库	Yes
Web 控件库	否
Windows 服务	Yes
网站	否

另请参阅

适用于

Play(Stream, AudioPlayMode)

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

播放.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 窗体应用程序中运行。

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

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

注解

该方法Play播放存储为文件、字节数组location或流中的data.wav声音文件stream。

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

`playMode`	Description
`AudioPlayMode.Background`	在后台播放声音。调用代码继续执行。
`AudioPlayMode.BackgroundLoop`	在后台播放声音，直到 Stop 调用该方法。调用代码继续执行。
`AudioPlayMode.WaitToComplete`	播放声音并等待它完成，直到调用代码继续。

后台播放允许应用程序在声音播放时执行其他代码。

有关详细信息，请参阅播放声音。

按项目类型提供可用性

项目类型	可用的
Windows 应用程序	Yes
类库	Yes
控制台应用程序	Yes
Windows 控件库	Yes
Web 控件库	否
Windows 服务	Yes
网站	否

另请参阅

适用于

Play(String, AudioPlayMode)

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

Source:: Audio.vb

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

存在部分信任的情况，用户缺少必要的权限。

示例

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

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

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

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

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

注解

该方法Play播放存储为文件、字节数组location或流中的data.wav声音文件stream。

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

`playMode`	Description
`AudioPlayMode.Background`	在后台播放声音。调用代码继续执行。
`AudioPlayMode.BackgroundLoop`	在后台播放声音，直到 Stop 调用该方法。调用代码继续执行。
`AudioPlayMode.WaitToComplete`	播放声音并等待它完成，直到调用代码继续。

后台播放允许应用程序在声音播放时执行其他代码。

有关详细信息，请参阅播放声音。

按项目类型提供可用性

项目类型	可用的
Windows 应用程序	Yes
类库	Yes
控制台应用程序	Yes
Windows 控件库	Yes
Web 控件库	否
Windows 服务	Yes
网站	否

另请参阅

适用于

反馈

此页面是否有帮助？