Audio.Play 方法

定义

命名空间:

Microsoft.VisualBasic.Devices

程序集:

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

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

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

注解

方法Play播放 .wav作为 文件location存储的声音文件，作为 中的字节数组或在 中datastream作为流播放。

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

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

应用程序可通过背景播放在播放声音时执行其他代码。

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

可用性（按项目类型）

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

另请参阅

• Stop()
• AudioPlayMode
• 对象 (Visual Basic)
• 播放声音 (Visual Basic)

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

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

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

注解

方法Play播放 .wav作为 文件location存储的声音文件，作为 中的字节数组或在 中datastream作为流播放。

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

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

应用程序可通过背景播放在播放声音时执行其他代码。

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

可用性（按项目类型）

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

另请参阅

• Stop()
• AudioPlayMode
• 对象 (Visual Basic)
• 播放声音 (Visual Basic)

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

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

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

注解

方法Play播放 .wav作为 文件location存储的声音文件，作为 中的字节数组或在 中datastream作为流播放。

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

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

应用程序可通过背景播放在播放声音时执行其他代码。

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

可用性（按项目类型）

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

另请参阅

• Stop()
• AudioPlayMode
• Stream
• 对象 (Visual Basic)
• 播放声音 (Visual Basic)

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

存在部分信任的情况，此时用户缺少足够的权限。

示例

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

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

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

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

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

注解

方法Play播放 .wav作为 文件location存储的声音文件，作为 中的字节数组或在 中datastream作为流播放。

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

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

应用程序可通过背景播放在播放声音时执行其他代码。

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

可用性（按项目类型）

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

另请参阅

• Stop()
• AudioPlayMode
• 对象 (Visual Basic)
• 播放声音 (Visual Basic)