Audio.Play Método

Definição

Namespace:: Microsoft.VisualBasic.Devices

Assembly:: Microsoft.VisualBasic.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Reproduz um arquivo de som .wav.

Sobrecargas

Nome	Description
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á malformado em location.

PathTooLongException

O nome location do caminho é 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 referenciar 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 em data, ou como um fluxo em stream.

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

`playMode`	Description
`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	Available
Aplicativo do Windows	Yes
Biblioteca de Classes	Yes
Aplicativo de console	Yes
Biblioteca de Controle do Windows	Yes
Biblioteca de Controles da Web	Não
Serviço do Windows	Yes
Site da web	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[]

Byte matriz que representa o arquivo de som.

playMode: AudioPlayMode

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

Exceções

ArgumentNullException

data é Nothing.

InvalidEnumArgumentException

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

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 referenciar 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 em data, ou como um fluxo em stream.

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

`playMode`	Description
`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	Available
Aplicativo do Windows	Yes
Biblioteca de Classes	Yes
Aplicativo de console	Yes
Biblioteca de Controle do Windows	Yes
Biblioteca de Controles da Web	Não
Serviço do Windows	Yes
Site da web	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

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

Exceções

ArgumentNullException

stream é Nothing.

InvalidEnumArgumentException

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

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 referenciar 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 em data, ou como um fluxo em stream.

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

`playMode`	Description
`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	Available
Aplicativo do Windows	Yes
Biblioteca de Classes	Yes
Aplicativo de console	Yes
Biblioteca de Controle do Windows	Yes
Biblioteca de Controles da Web	Não
Serviço do Windows	Yes
Site da web	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

AudioPlayMode modo para reproduzir o 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á malformado em location.

PathTooLongException

O nome location do caminho é muito longo.

InvalidEnumArgumentException

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

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 referenciar 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 em data, ou como um fluxo em stream.

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

`playMode`	Description
`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	Available
Aplicativo do Windows	Yes
Biblioteca de Classes	Yes
Aplicativo de console	Yes
Biblioteca de Controle do Windows	Yes
Biblioteca de Controles da Web	Não
Serviço do Windows	Yes
Site da web	Não

Confira também

Aplica-se a

Comentários

Esta página foi útil?