Audio.Play Método

Definição

Espaço de Nomes:: Microsoft.VisualBasic.Devices

Assemblagem:: Microsoft.VisualBasic.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Reproduz um ficheiro de som .wav.

Sobrecargas

Name	Description
Play(String)	Reproduz um ficheiro de som .wav.
Play(Byte[], AudioPlayMode)	Reproduz um ficheiro de som .wav.
Play(Stream, AudioPlayMode)	Reproduz um ficheiro de som .wav.
Play(String, AudioPlayMode)	Reproduz um ficheiro de som .wav.

Play(String)

Reproduz um ficheiro de som .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

A String contendo o nome do ficheiro de som.

Exceções

ArgumentNullException

location é uma corda vazia.

IOException

O utilizador não tem permissões suficientes para aceder ao ficheiro nomeado por location.

DirectoryNotFoundException

O caminho do ficheiro é malformado em location.

PathTooLongException

O nome do percurso é location demasiado longo.

SecurityException

Existe uma situação de confiança parcial em que o utilizador não possui as permissões necessárias.

Exemplos

O My.Computer.Audio.Play método reproduz o som especificado em segundo plano quando PlayMode.Background é especificado.

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

Este exemplo de código só pode ser executado dentro de uma aplicação Windows Forms.

O nome do ficheiro deve referir-se a um ficheiro .wav de som no seu sistema.

Para simplificar a gestão dos seus ficheiros de som, considere armazenar os ficheiros como recursos de aplicação. Podem então ser acedidos através do My.Resources objeto.

Observações

O Play método reproduz o ficheiro de som .wav armazenado como um ficheiro em location, como um array de bytes em data, ou como um fluxo em stream.

Se for usada a sobrecarga que ocupa apenas o location parâmetro, o Play método reproduz o som em fundo. Caso contrário, o playMode parâmetro determina como o som será tocado.

`playMode`	Description
`AudioPlayMode.Background`	Toca o som ao fundo. O código de chamada continua a executar-se.
`AudioPlayMode.BackgroundLoop`	Reproduz o som em fundo até o Stop método ser chamado. O código de chamada continua a executar-se.
`AudioPlayMode.WaitToComplete`	Reproduz o som e espera até terminar antes de o código de chamada continuar.

A reprodução em segundo plano permite que a aplicação execute outro código enquanto o som é tocado.

Para mais informações, veja Tocar Sons.

Disponibilidade por tipo de projeto

Tipo de Projeto	Available
Aplicação do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo de console	Sim
Biblioteca de Controlo do Windows	Sim
Biblioteca de controle da Web	No
Serviço Windows	Sim
Web site	No

Ver também

Aplica-se a

Play(Byte[], AudioPlayMode)

Reproduz um ficheiro de som .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[]

Byte array que representa o ficheiro de som.

playMode: AudioPlayMode

AudioPlayMode modo para tocar o som. Por padrão, AudioPlayMode.Background.

Exceções

ArgumentNullException

data é Nothing.

InvalidEnumArgumentException

playMode não é um dos AudioPlayMode valores de enumeração.

SecurityException

Existe uma situação de confiança parcial em que o utilizador não possui as permissões necessárias.

Exemplos

O My.Computer.Audio.Play método reproduz o som especificado em segundo plano quando PlayMode.Background é especificado.

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

Este exemplo de código só pode ser executado dentro de uma aplicação Windows Forms.

O nome do ficheiro deve referir-se a um ficheiro .wav de som no seu sistema.

Para simplificar a gestão dos seus ficheiros de som, considere armazenar os ficheiros como recursos de aplicação. Podem então ser acedidos através do My.Resources objeto.

Observações

O Play método reproduz o ficheiro de som .wav armazenado como um ficheiro em location, como um array de bytes em data, ou como um fluxo em stream.

Se for usada a sobrecarga que ocupa apenas o location parâmetro, o Play método reproduz o som em fundo. Caso contrário, o playMode parâmetro determina como o som será tocado.

`playMode`	Description
`AudioPlayMode.Background`	Toca o som ao fundo. O código de chamada continua a executar-se.
`AudioPlayMode.BackgroundLoop`	Reproduz o som em fundo até o Stop método ser chamado. O código de chamada continua a executar-se.
`AudioPlayMode.WaitToComplete`	Reproduz o som e espera até terminar antes de o código de chamada continuar.

A reprodução em segundo plano permite que a aplicação execute outro código enquanto o som é tocado.

Para mais informações, veja Tocar Sons.

Disponibilidade por tipo de projeto

Tipo de Projeto	Available
Aplicação do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo de console	Sim
Biblioteca de Controlo do Windows	Sim
Biblioteca de controle da Web	No
Serviço Windows	Sim
Web site	No

Ver também

Aplica-se a

Play(Stream, AudioPlayMode)

Reproduz um ficheiro de som .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 o ficheiro de som.

playMode: AudioPlayMode

AudioPlayMode modo para tocar o som. Por padrão, AudioPlayMode.Background.

Exceções

ArgumentNullException

stream é Nothing.

InvalidEnumArgumentException

playMode não é um dos AudioPlayMode valores de enumeração.

SecurityException

Existe uma situação de confiança parcial em que o utilizador não possui as permissões necessárias.

Exemplos

O My.Computer.Audio.Play método reproduz o som especificado em segundo plano quando PlayMode.Background é especificado.

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

Este exemplo de código só pode ser executado dentro de uma aplicação Windows Forms.

O nome do ficheiro deve referir-se a um ficheiro .wav de som no seu sistema.

Para simplificar a gestão dos seus ficheiros de som, considere armazenar os ficheiros como recursos de aplicação. Podem então ser acedidos através do My.Resources objeto.

Observações

O Play método reproduz o ficheiro de som .wav armazenado como um ficheiro em location, como um array de bytes em data, ou como um fluxo em stream.

Se for usada a sobrecarga que ocupa apenas o location parâmetro, o Play método reproduz o som em fundo. Caso contrário, o playMode parâmetro determina como o som será tocado.

`playMode`	Description
`AudioPlayMode.Background`	Toca o som ao fundo. O código de chamada continua a executar-se.
`AudioPlayMode.BackgroundLoop`	Reproduz o som em fundo até o Stop método ser chamado. O código de chamada continua a executar-se.
`AudioPlayMode.WaitToComplete`	Reproduz o som e espera até terminar antes de o código de chamada continuar.

A reprodução em segundo plano permite que a aplicação execute outro código enquanto o som é tocado.

Para mais informações, veja Tocar Sons.

Disponibilidade por tipo de projeto

Tipo de Projeto	Available
Aplicação do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo de console	Sim
Biblioteca de Controlo do Windows	Sim
Biblioteca de controle da Web	No
Serviço Windows	Sim
Web site	No

Ver também

Aplica-se a

Play(String, AudioPlayMode)

Reproduz um ficheiro de som .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

A String contendo o nome do ficheiro de som.

playMode: AudioPlayMode

AudioPlayMode modo para tocar o som. Por padrão, AudioPlayMode.Background.

Exceções

ArgumentNullException

location é uma corda vazia.

IOException

O utilizador não tem permissões suficientes para aceder ao ficheiro nomeado por location.

DirectoryNotFoundException

O caminho do ficheiro é malformado em location.

PathTooLongException

O nome do percurso é location demasiado longo.

InvalidEnumArgumentException

playMode não é um dos AudioPlayMode valores de enumeração.

SecurityException

Existe uma situação de confiança parcial em que o utilizador não possui as permissões necessárias.

Exemplos

O My.Computer.Audio.Play método reproduz o som especificado em segundo plano quando PlayMode.Background é especificado.

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

Este exemplo de código só pode ser executado dentro de uma aplicação Windows Forms.

O nome do ficheiro deve referir-se a um ficheiro .wav de som no seu sistema.

Para simplificar a gestão dos seus ficheiros de som, considere armazenar os ficheiros como recursos de aplicação. Podem então ser acedidos através do My.Resources objeto.

Observações

O Play método reproduz o ficheiro de som .wav armazenado como um ficheiro em location, como um array de bytes em data, ou como um fluxo em stream.

Se for usada a sobrecarga que ocupa apenas o location parâmetro, o Play método reproduz o som em fundo. Caso contrário, o playMode parâmetro determina como o som será tocado.

`playMode`	Description
`AudioPlayMode.Background`	Toca o som ao fundo. O código de chamada continua a executar-se.
`AudioPlayMode.BackgroundLoop`	Reproduz o som em fundo até o Stop método ser chamado. O código de chamada continua a executar-se.
`AudioPlayMode.WaitToComplete`	Reproduz o som e espera até terminar antes de o código de chamada continuar.

A reprodução em segundo plano permite que a aplicação execute outro código enquanto o som é tocado.

Para mais informações, veja Tocar Sons.

Disponibilidade por tipo de projeto

Tipo de Projeto	Available
Aplicação do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo de console	Sim
Biblioteca de Controlo do Windows	Sim
Biblioteca de controle da Web	No
Serviço Windows	Sim
Web site	No

Ver também

Aplica-se a

Comentários

Esta página foi útil?