Compartir vía

Audio.Play Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.VisualBasic.Devices
Ensamblado:
Microsoft.VisualBasic.dll
Ensamblado:
Microsoft.VisualBasic.Forms.dll

Reproduce un archivo de sonido .wav.

Sobrecargas

Play(String)

Reproduce un archivo de sonido .wav.
Play(Byte[], AudioPlayMode)

Reproduce un archivo de sonido .wav.
Play(Stream, AudioPlayMode)

Reproduce un archivo de sonido .wav.
Play(String, AudioPlayMode)

Reproduce un archivo de sonido .wav.

Play(String)

Reproduce un archivo de sonido .wav.

public:
 void Play(System::String ^ location);
public void Play (string location);
member this.Play : string -> unit
Public Sub Play (location As String)

Parámetros

location
String

que String contiene el nombre del archivo de sonido.

Excepciones

ArgumentNullException

location es una cadena vacía.

IOException

El usuario no tiene permisos suficientes para obtener acceso al archivo especificado por location.

DirectoryNotFoundException

La ruta de acceso del archivo es incorrecta en location.

PathTooLongException

El nombre de la ruta de acceso de location es demasiado largo.

SecurityException

Hay una situación de confianza parcial en la que el usuario no dispone de los permisos necesarios.

Ejemplos

El My.Computer.Audio.Play método reproduce el sonido especificado en segundo plano cuando PlayMode.Background se especifica .

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

Este ejemplo de código solo se puede ejecutar dentro de una aplicación Windows Forms.

El nombre de archivo debe hacer referencia a un archivo de sonido .wav en el sistema.

Para simplificar la administración de los archivos de sonido, considere la posibilidad de almacenar los archivos como recursos de la aplicación. A continuación, se puede acceder a ellos a través del My.Resources objeto .

Comentarios

El Play método reproduce el archivo de sonido .wav almacenado como un archivo en location, como una matriz de bytes en datao como una secuencia en stream.

Si se usa la sobrecarga que toma solo el location parámetro , el Play método reproduce el sonido en segundo plano. De lo contrario, el playMode parámetro determina cómo se reproducirá el sonido.

playMode Descripción
AudioPlayMode.Background Reproduce el sonido en segundo plano. El código de llamada continúa ejecutándose.
AudioPlayMode.BackgroundLoop Reproduce el sonido en segundo plano hasta que se llama al Stop método . El código de llamada continúa ejecutándose.
AudioPlayMode.WaitToComplete Reproduce el sonido y espera hasta que finalice antes de que continúe el código que realiza la llamada.

La reproducción en segundo plano permite que la aplicación ejecute otro código mientras se reproduce el sonido.

Para más información, consulte Reproducir sonidos.

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación Windows Sí
Biblioteca de clases Sí
Aplicación de consola Sí
Biblioteca de controles de Windows Sí
Biblioteca de controles web No
Servicio de Windows Sí
Sitio web No

Consulte también

Se aplica a

Play(Byte[], AudioPlayMode)

Reproduce un archivo de sonido .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)

Parámetros

data
Byte[]

Matriz de Byte que representa el archivo de sonido.

playMode
AudioPlayMode

Modo AudioPlayMode para reproducir el sonido. De manera predeterminada, es AudioPlayMode.Background.

Excepciones

ArgumentNullException

data es Nothing.

InvalidEnumArgumentException

playMode no es ninguno de los valores de la enumeración AudioPlayMode.

SecurityException

Hay una situación de confianza parcial en la que el usuario no dispone de los permisos necesarios.

Ejemplos

El My.Computer.Audio.Play método reproduce el sonido especificado en segundo plano cuando PlayMode.Background se especifica .

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

Este ejemplo de código solo se puede ejecutar dentro de una aplicación Windows Forms.

El nombre de archivo debe hacer referencia a un archivo de sonido .wav en el sistema.

Para simplificar la administración de los archivos de sonido, considere la posibilidad de almacenar los archivos como recursos de la aplicación. A continuación, se puede acceder a ellos a través del My.Resources objeto .

Comentarios

El Play método reproduce el archivo de sonido .wav almacenado como un archivo en location, como una matriz de bytes en datao como una secuencia en stream.

Si se usa la sobrecarga que toma solo el location parámetro , el Play método reproduce el sonido en segundo plano. De lo contrario, el playMode parámetro determina cómo se reproducirá el sonido.

playMode Descripción
AudioPlayMode.Background Reproduce el sonido en segundo plano. El código de llamada continúa ejecutándose.
AudioPlayMode.BackgroundLoop Reproduce el sonido en segundo plano hasta que se llama al Stop método . El código de llamada continúa ejecutándose.
AudioPlayMode.WaitToComplete Reproduce el sonido y espera hasta que finalice antes de que continúe el código que realiza la llamada.

La reproducción en segundo plano permite que la aplicación ejecute otro código mientras se reproduce el sonido.

Para más información, consulte Reproducir sonidos.

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación Windows Sí
Biblioteca de clases Sí
Aplicación de consola Sí
Biblioteca de controles de Windows Sí
Biblioteca de controles web No
Servicio de Windows Sí
Sitio web No

Consulte también

Se aplica a

Play(Stream, AudioPlayMode)

Reproduce un archivo de sonido .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)

Parámetros

stream
Stream

Stream que representa el archivo de sonido.

playMode
AudioPlayMode

Modo AudioPlayMode para reproducir el sonido. De manera predeterminada, es AudioPlayMode.Background.

Excepciones

ArgumentNullException

stream es Nothing.

InvalidEnumArgumentException

playMode no es ninguno de los valores de la enumeración AudioPlayMode.

SecurityException

Hay una situación de confianza parcial en la que el usuario no dispone de los permisos necesarios.

Ejemplos

El My.Computer.Audio.Play método reproduce el sonido especificado en segundo plano cuando PlayMode.Background se especifica .

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

Este ejemplo de código solo se puede ejecutar dentro de una aplicación Windows Forms.

El nombre de archivo debe hacer referencia a un archivo de sonido .wav en el sistema.

Para simplificar la administración de los archivos de sonido, considere la posibilidad de almacenar los archivos como recursos de la aplicación. A continuación, se puede acceder a ellos a través del My.Resources objeto .

Comentarios

El Play método reproduce el archivo de sonido .wav almacenado como un archivo en location, como una matriz de bytes en datao como una secuencia en stream.

Si se usa la sobrecarga que toma solo el location parámetro , el Play método reproduce el sonido en segundo plano. De lo contrario, el playMode parámetro determina cómo se reproducirá el sonido.

playMode Descripción
AudioPlayMode.Background Reproduce el sonido en segundo plano. El código de llamada continúa ejecutándose.
AudioPlayMode.BackgroundLoop Reproduce el sonido en segundo plano hasta que se llama al Stop método . El código de llamada continúa ejecutándose.
AudioPlayMode.WaitToComplete Reproduce el sonido y espera hasta que finalice antes de que continúe el código que realiza la llamada.

La reproducción en segundo plano permite que la aplicación ejecute otro código mientras se reproduce el sonido.

Para más información, consulte Reproducir sonidos.

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación Windows Sí
Biblioteca de clases Sí
Aplicación de consola Sí
Biblioteca de controles de Windows Sí
Biblioteca de controles web No
Servicio de Windows Sí
Sitio web No

Consulte también

Se aplica a

Play(String, AudioPlayMode)

Reproduce un archivo de sonido .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)

Parámetros

location
String

que String contiene el nombre del archivo de sonido.

playMode
AudioPlayMode

Modo AudioPlayMode para reproducir el sonido. De manera predeterminada, es AudioPlayMode.Background.

Excepciones

ArgumentNullException

location es una cadena vacía.

IOException

El usuario no tiene permisos suficientes para obtener acceso al archivo especificado por location.

DirectoryNotFoundException

La ruta de acceso del archivo es incorrecta en location.

PathTooLongException

El nombre de la ruta de acceso de location es demasiado largo.

InvalidEnumArgumentException

playMode no es ninguno de los valores de la enumeración AudioPlayMode.

SecurityException

Hay una situación de confianza parcial en la que el usuario no dispone de los permisos necesarios.

Ejemplos

El My.Computer.Audio.Play método reproduce el sonido especificado en segundo plano cuando PlayMode.Background se especifica .

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

Este ejemplo de código solo se puede ejecutar dentro de una aplicación Windows Forms.

El nombre de archivo debe hacer referencia a un archivo de sonido .wav en el sistema.

Para simplificar la administración de los archivos de sonido, considere la posibilidad de almacenar los archivos como recursos de la aplicación. A continuación, se puede acceder a ellos a través del My.Resources objeto .

Comentarios

El Play método reproduce el archivo de sonido .wav almacenado como un archivo en location, como una matriz de bytes en datao como una secuencia en stream.

Si se usa la sobrecarga que toma solo el location parámetro , el Play método reproduce el sonido en segundo plano. De lo contrario, el playMode parámetro determina cómo se reproducirá el sonido.

playMode Descripción
AudioPlayMode.Background Reproduce el sonido en segundo plano. El código de llamada continúa ejecutándose.
AudioPlayMode.BackgroundLoop Reproduce el sonido en segundo plano hasta que se llama al Stop método . El código de llamada continúa ejecutándose.
AudioPlayMode.WaitToComplete Reproduce el sonido y espera hasta que finalice antes de que continúe el código que realiza la llamada.

La reproducción en segundo plano permite que la aplicación ejecute otro código mientras se reproduce el sonido.

Para más información, consulte Reproducir sonidos.

Disponibilidad por tipo de proyecto

Tipo de proyecto Disponible
Aplicación Windows Sí
Biblioteca de clases Sí
Aplicación de consola Sí
Biblioteca de controles de Windows Sí
Biblioteca de controles web No
Servicio de Windows Sí
Sitio web No

Consulte también

Se aplica a