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)

Исходный код:

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 Forms.

Имя файла должно ссылаться на .wav звуковой файл в системе.

Чтобы упростить управление звуковыми файлами, рассмотрите возможность хранения файлов в качестве ресурсов приложения. Затем их можно получить через My.Resources объект.

Комментарии

Метод Play воспроизводит .wav звуковой файл, хранящийся в виде файла locationв dataвиде массива байтов или в виде потока.stream

Если используется перегрузка, которая принимает только location параметр, Play метод воспроизводит звук в фоновом режиме. В противном случае параметр определяет, playMode как будет воспроизводиться звук.

playMode	Description
AudioPlayMode.Background	Воспроизводит звук в фоновом режиме. Вызывающий код продолжает выполняться.
AudioPlayMode.BackgroundLoop	Воспроизводит звук в фоновом режиме до Stop вызова метода. Вызывающий код продолжает выполняться.
AudioPlayMode.WaitToComplete	Воспроизводит звук и ожидает завершения, пока не завершится вызов кода.

Фоновое воспроизведение позволяет приложению выполнять другой код во время воспроизведения звука.

Дополнительные сведения см. в разделе "Воспроизведение звуков".

Доступность по типу проекта

тип проекта	В наличии
Приложение Windows	Yes
Библиотека классов	Yes
Консольное приложение	Yes
Библиотека элементов управления Windows	Yes
Библиотека веб-элементов управления	Нет
Службы Windows	Yes
Веб-сайт	Нет

См. также раздел

• Stop()
• AudioPlayMode
• Объекты (Visual Basic)
• Запуск звуков (Visual Basic)

Play(Byte[], AudioPlayMode)

Исходный код:

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 Forms.

Имя файла должно ссылаться на .wav звуковой файл в системе.

Чтобы упростить управление звуковыми файлами, рассмотрите возможность хранения файлов в качестве ресурсов приложения. Затем их можно получить через My.Resources объект.

Комментарии

Метод Play воспроизводит .wav звуковой файл, хранящийся в виде файла locationв dataвиде массива байтов или в виде потока.stream

Если используется перегрузка, которая принимает только location параметр, Play метод воспроизводит звук в фоновом режиме. В противном случае параметр определяет, playMode как будет воспроизводиться звук.

playMode	Description
AudioPlayMode.Background	Воспроизводит звук в фоновом режиме. Вызывающий код продолжает выполняться.
AudioPlayMode.BackgroundLoop	Воспроизводит звук в фоновом режиме до Stop вызова метода. Вызывающий код продолжает выполняться.
AudioPlayMode.WaitToComplete	Воспроизводит звук и ожидает завершения, пока не завершится вызов кода.

Фоновое воспроизведение позволяет приложению выполнять другой код во время воспроизведения звука.

Дополнительные сведения см. в разделе "Воспроизведение звуков".

Доступность по типу проекта

тип проекта	В наличии
Приложение Windows	Yes
Библиотека классов	Yes
Консольное приложение	Yes
Библиотека элементов управления Windows	Yes
Библиотека веб-элементов управления	Нет
Службы Windows	Yes
Веб-сайт	Нет

См. также раздел

• Stop()
• AudioPlayMode
• Объекты (Visual Basic)
• Запуск звуков (Visual Basic)

Play(Stream, AudioPlayMode)

Исходный код:

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 Forms.

Имя файла должно ссылаться на .wav звуковой файл в системе.

Чтобы упростить управление звуковыми файлами, рассмотрите возможность хранения файлов в качестве ресурсов приложения. Затем их можно получить через My.Resources объект.

Комментарии

Метод Play воспроизводит .wav звуковой файл, хранящийся в виде файла locationв dataвиде массива байтов или в виде потока.stream

Если используется перегрузка, которая принимает только location параметр, Play метод воспроизводит звук в фоновом режиме. В противном случае параметр определяет, playMode как будет воспроизводиться звук.

playMode	Description
AudioPlayMode.Background	Воспроизводит звук в фоновом режиме. Вызывающий код продолжает выполняться.
AudioPlayMode.BackgroundLoop	Воспроизводит звук в фоновом режиме до Stop вызова метода. Вызывающий код продолжает выполняться.
AudioPlayMode.WaitToComplete	Воспроизводит звук и ожидает завершения, пока не завершится вызов кода.

Фоновое воспроизведение позволяет приложению выполнять другой код во время воспроизведения звука.

Дополнительные сведения см. в разделе "Воспроизведение звуков".

Доступность по типу проекта

тип проекта	В наличии
Приложение Windows	Yes
Библиотека классов	Yes
Консольное приложение	Yes
Библиотека элементов управления Windows	Yes
Библиотека веб-элементов управления	Нет
Службы Windows	Yes
Веб-сайт	Нет

См. также раздел

• Stop()
• AudioPlayMode
• Stream
• Объекты (Visual Basic)
• Запуск звуков (Visual Basic)

Play(String, AudioPlayMode)

Исходный код:

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 Forms.

Имя файла должно ссылаться на .wav звуковой файл в системе.

Чтобы упростить управление звуковыми файлами, рассмотрите возможность хранения файлов в качестве ресурсов приложения. Затем их можно получить через My.Resources объект.

Комментарии

Метод Play воспроизводит .wav звуковой файл, хранящийся в виде файла locationв dataвиде массива байтов или в виде потока.stream

Если используется перегрузка, которая принимает только location параметр, Play метод воспроизводит звук в фоновом режиме. В противном случае параметр определяет, playMode как будет воспроизводиться звук.

playMode	Description
AudioPlayMode.Background	Воспроизводит звук в фоновом режиме. Вызывающий код продолжает выполняться.
AudioPlayMode.BackgroundLoop	Воспроизводит звук в фоновом режиме до Stop вызова метода. Вызывающий код продолжает выполняться.
AudioPlayMode.WaitToComplete	Воспроизводит звук и ожидает завершения, пока не завершится вызов кода.

Фоновое воспроизведение позволяет приложению выполнять другой код во время воспроизведения звука.

Дополнительные сведения см. в разделе "Воспроизведение звуков".

Доступность по типу проекта

тип проекта	В наличии
Приложение Windows	Yes
Библиотека классов	Yes
Консольное приложение	Yes
Библиотека элементов управления Windows	Yes
Библиотека веб-элементов управления	Нет
Службы Windows	Yes
Веб-сайт	Нет

См. также раздел

• Stop()
• AudioPlayMode
• Объекты (Visual Basic)
• Запуск звуков (Visual Basic)