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 Forms приложении.

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

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

Комментарии

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

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

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

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

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

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

Тип проекта	Доступно
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Службы 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 Forms приложении.

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

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

Комментарии

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

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

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

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

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

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

Тип проекта	Доступно
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Службы 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 Forms приложении.

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

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

Комментарии

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

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

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

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

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

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

Тип проекта	Доступно
Приложение Windows	Да
Библиотека классов	Да
Консольное приложение	Да
Библиотека элементов управления Windows	Да
Библиотека веб-элементов управления	Нет
Службы 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 Forms приложении.

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

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

Комментарии

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

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

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

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

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

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

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

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

• Stop()
• AudioPlayMode
• Объекты (Visual Basic)
• Воспроизведение звуков (Visual Basic)