Metodo My.Computer.Audio.Play

Articolo
09/12/2008

Aggiornamento: novembre 2007

Riproduce un file audio wav.

' Usage
My.Computer.Audio.Play(location)
My.Computer.Audio.Play(location ,playMode)
My.Computer.Audio.Play(data ,playMode)
My.Computer.Audio.Play(stream ,playMode)
' Declaration
Public Sub Play( _
   ByVal location As String _
)
' -or-
Public Sub Play( _
   ByVal location As String, _
   ByVal playMode As AudioPlayMode _
)
' -or-
Public Sub Play( _
   ByVal data As Byte(), _
   ByVal playMode As AudioPlayMode _
)
' -or-
Public Sub Play( _
   ByVal stream As System.IO.Stream, _
   ByVal playMode As AudioPlayMode _
)

Parametri

location
Stringa String contenente il nome del file audio
data
Matrice di Byte che rappresenta il file audio.
stream
Stream che rappresenta il file audio.
playMode
Modalità Enumerazione AudioPlayMode di riproduzione del suono. Per valore predefinito, AudioPlayMode.Background.

Eccezioni

Le seguenti condizioni possono causare un'eccezione:

data o stream è Nothing, oppure location è una stringa vuota (ArgumentNullException).
L'argomento playMode non è uno dei valori Enumerazione AudioPlayMode (InvalidEnumArgumentException).
L'utente non dispone di autorizzazioni sufficienti per accedere al file denominato da location (IOException).
Il percorso del file in location non è corretto (DirectoryNotFoundException)
Il nome del percorso in location è troppo lungo (PathTooLongException)
Sussiste una situazione di attendibilità parziale in cui l'utente non dispone delle autorizzazioni necessarie(SecurityException).

Note

Il metodo Play riproduce il file audio con estensione wav archiviato come file in location, come matrice di byte in data o come flusso in stream.

Se viene utilizzato l'overload che accetta esclusivamente il parametro location, il metodo Play determinerà la riproduzione del suono in background. In caso diverso, la modalità di riproduzione del suono verrà determinata dal parametro playMode.

playMode	Descrizione
AudioPlayMode.Background	Riproduce il suono in background. Il codice chiamante continua l'esecuzione.
AudioPlayMode.BackgroundLoop	Riproduce il suono in background fino a che non viene chiamato Metodo My.Computer.Audio.Stop. Il codice chiamante continua l'esecuzione.
AudioPlayMode.WaitToComplete	Riproduce il suono e attende che l'operazione venga completata prima di riprendere l'esecuzione del codice chiamante.

La riproduzione in background consente all'applicazione di eseguire altro codice mentre il suono viene riprodotto. Per ulteriori informazioni, vedere Procedura: riprodurre suoni ciclici in Visual Basic e Procedura: riprodurre suoni in Visual Basic.

Attività

Nella tabella riportata di seguito sono elencati esempi di attività relative al metodo My.Computer.Audio.Play.

Per	Vedere
Riprodurre suoni una sola volta	Procedura: riprodurre suoni e attenderne il completamento in Visual Basic
Riprodurre suoni più di una volta	Procedura: riprodurre suoni ciclici in Visual Basic
Riprodurre suoni in background.	Procedura: riprodurre suoni in Visual Basic

Esempio

Il metodo My.Computer.Audio.Play consente di riprodurre in background il suono indicato quando viene specificato PlayMode.Background.

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

L'esempio di codice può essere eseguito solo in un'applicazione Windows Form.

È necessario che il nome del file faccia riferimento a un file audio con estensione wav presente nel sistema.

Per semplificare la gestione dei file audio, è possibile archiviare i file come risorse dell'applicazione. È quindi possibile accedervi attraverso Oggetto My.Resources.

Requisiti

Spazio dei nomi:Microsoft.VisualBasic.Devices

Classe:Audio

Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)

Disponibilità in base al tipo di progetto

Tipo di progetto	Disponibile
Applicazione Windows	Sì
Libreria di classi	Sì
Applicazione di console	Sì
Libreria di controlli Windows	Sì
Libreria di controllo Web	No
Servizio Windows	Sì
Sito Web	No

Autorizzazioni

Possono essere necessarie le autorizzazioni seguenti:

Autorizzazione	Descrizione
FileIOPermission	Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.
SecurityPermission	Descrive un insieme di autorizzazioni di protezione applicate al codice. Enumerazione associata: ControlThread.