Audio.Play Método

Definição

Namespace:

Microsoft.VisualBasic.Devices

Assembly:

Microsoft.VisualBasic.Forms.dll

Reproduz um arquivo de som .wav.

Sobrecargas

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

Play(String)

Reproduz um arquivo 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

Um String que contém o nome do arquivo de som.

Exceções

ArgumentNullException

location é uma cadeia de caracteres vazia.

IOException

O usuário não tem permissões suficientes para acessar o arquivo nomeado por location.

DirectoryNotFoundException

O caminho do arquivo está mal formado em location.

PathTooLongException

O nome do caminho em location é muito longo.

SecurityException

Existe uma situação de confiança parcial na qual o usuário não tem 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 em um aplicativo Windows Forms.

O nome do arquivo deve fazer referência a um arquivo de som .wav em seu sistema.

Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos de aplicativo. Em seguida, eles podem ser acessados por meio do My.Resources objeto .

Comentários

O Play método reproduz o arquivo de som .wav armazenado como um arquivo em location, como uma matriz de bytes no dataou como um fluxo no stream.

Se a sobrecarga que usa apenas o location parâmetro for usada, o Play método reproduzirá o som em segundo plano. Caso contrário, o playMode parâmetro determina como o som será reproduzido.

playMode	Descrição
AudioPlayMode.Background	Reproduz o som em segundo plano. O código de chamada continua a ser executado.
AudioPlayMode.BackgroundLoop	Reproduz o som em segundo plano até que o Stop método seja chamado. O código de chamada continua a ser executado.
AudioPlayMode.WaitToComplete	Reproduz o som e aguarda até que ele seja concluído antes que o código de chamada continue.

A reprodução em segundo plano permite que o aplicativo execute outro código enquanto o som é reproduzido.

Para obter mais informações, consulte Como reproduzir sons.

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo do Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controles da Web	Não
Serviço do Windows	Sim
Site	Não

Confira também

• Stop()
• AudioPlayMode
• Objetos (Visual Basic)
• Executando sons (Visual Basic)

Play(Byte[], AudioPlayMode)

Reproduz um arquivo 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[]

Matriz Byte que representa o arquivo de som.

playMode

AudioPlayMode

O modo AudioPlayMode de reprodução do som. Por padrão, AudioPlayMode.Background.

Exceções

ArgumentNullException

data é Nothing.

InvalidEnumArgumentException

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

SecurityException

Existe uma situação de confiança parcial na qual o usuário não tem 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 em um aplicativo Windows Forms.

O nome do arquivo deve fazer referência a um arquivo de som .wav em seu sistema.

Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos de aplicativo. Em seguida, eles podem ser acessados por meio do My.Resources objeto .

Comentários

O Play método reproduz o arquivo de som .wav armazenado como um arquivo em location, como uma matriz de bytes no dataou como um fluxo no stream.

Se a sobrecarga que usa apenas o location parâmetro for usada, o Play método reproduzirá o som em segundo plano. Caso contrário, o playMode parâmetro determina como o som será reproduzido.

playMode	Descrição
AudioPlayMode.Background	Reproduz o som em segundo plano. O código de chamada continua a ser executado.
AudioPlayMode.BackgroundLoop	Reproduz o som em segundo plano até que o Stop método seja chamado. O código de chamada continua a ser executado.
AudioPlayMode.WaitToComplete	Reproduz o som e aguarda até que ele seja concluído antes que o código de chamada continue.

A reprodução em segundo plano permite que o aplicativo execute outro código enquanto o som é reproduzido.

Para obter mais informações, consulte Como reproduzir sons.

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo do Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controles da Web	Não
Serviço do Windows	Sim
Site	Não

Confira também

• Stop()
• AudioPlayMode
• Objetos (Visual Basic)
• Executando sons (Visual Basic)

Play(Stream, AudioPlayMode)

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

playMode

AudioPlayMode

O modo AudioPlayMode de reprodução do som. Por padrão, AudioPlayMode.Background.

Exceções

ArgumentNullException

stream é Nothing.

InvalidEnumArgumentException

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

SecurityException

Existe uma situação de confiança parcial na qual o usuário não tem 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 em um aplicativo Windows Forms.

O nome do arquivo deve fazer referência a um arquivo de som .wav em seu sistema.

Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos de aplicativo. Em seguida, eles podem ser acessados por meio do My.Resources objeto .

Comentários

O Play método reproduz o arquivo de som .wav armazenado como um arquivo em location, como uma matriz de bytes no dataou como um fluxo no stream.

Se a sobrecarga que usa apenas o location parâmetro for usada, o Play método reproduzirá o som em segundo plano. Caso contrário, o playMode parâmetro determina como o som será reproduzido.

playMode	Descrição
AudioPlayMode.Background	Reproduz o som em segundo plano. O código de chamada continua a ser executado.
AudioPlayMode.BackgroundLoop	Reproduz o som em segundo plano até que o Stop método seja chamado. O código de chamada continua a ser executado.
AudioPlayMode.WaitToComplete	Reproduz o som e aguarda até que ele seja concluído antes que o código de chamada continue.

A reprodução em segundo plano permite que o aplicativo execute outro código enquanto o som é reproduzido.

Para obter mais informações, consulte Como reproduzir sons.

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo do Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controles da Web	Não
Serviço do Windows	Sim
Site	Não

Confira também

• Stop()
• AudioPlayMode
• Stream
• Objetos (Visual Basic)
• Executando sons (Visual Basic)

Play(String, AudioPlayMode)

Reproduz um arquivo 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

Um String que contém o nome do arquivo de som.

playMode

AudioPlayMode

O modo AudioPlayMode de reprodução do som. Por padrão, AudioPlayMode.Background.

Exceções

ArgumentNullException

location é uma cadeia de caracteres vazia.

IOException

O usuário não tem permissões suficientes para acessar o arquivo nomeado por location.

DirectoryNotFoundException

O caminho do arquivo está mal formado em location.

PathTooLongException

O nome do caminho em location é muito longo.

InvalidEnumArgumentException

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

SecurityException

Existe uma situação de confiança parcial na qual o usuário não tem 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 em um aplicativo Windows Forms.

O nome do arquivo deve fazer referência a um arquivo de som .wav em seu sistema.

Para simplificar o gerenciamento de seus arquivos de som, considere armazenar os arquivos como recursos de aplicativo. Em seguida, eles podem ser acessados por meio do My.Resources objeto .

Comentários

O Play método reproduz o arquivo de som .wav armazenado como um arquivo em location, como uma matriz de bytes no dataou como um fluxo no stream.

Se a sobrecarga que usa apenas o location parâmetro for usada, o Play método reproduzirá o som em segundo plano. Caso contrário, o playMode parâmetro determina como o som será reproduzido.

playMode	Descrição
AudioPlayMode.Background	Reproduz o som em segundo plano. O código de chamada continua a ser executado.
AudioPlayMode.BackgroundLoop	Reproduz o som em segundo plano até que o Stop método seja chamado. O código de chamada continua a ser executado.
AudioPlayMode.WaitToComplete	Reproduz o som e aguarda até que ele seja concluído antes que o código de chamada continue.

A reprodução em segundo plano permite que o aplicativo execute outro código enquanto o som é reproduzido.

Para obter mais informações, consulte Como reproduzir sons.

Disponibilidade por tipo de projeto

Tipo de projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classes	Sim
Aplicativo do Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controles da Web	Não
Serviço do Windows	Sim
Site	Não

Confira também

• Stop()
• AudioPlayMode
• Objetos (Visual Basic)
• Executando sons (Visual Basic)