Partilhar via


Audio.Play Método

Definição

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

location é uma cadeia de caracteres vazia.

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

O caminho do arquivo está mal formado em location.

O nome do caminho em location é muito longo.

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

Aplica-se a

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

data é Nothing.

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

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

Aplica-se a

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

stream é Nothing.

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

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

Aplica-se a

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

location é uma cadeia de caracteres vazia.

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

O caminho do arquivo está mal formado em location.

O nome do caminho em location é muito longo.

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

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

Aplica-se a