My.Computer.Audio.Play, méthode

Article
08/21/2008

Mise à jour : novembre 2007

Lit un fichier 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 _
)

Paramètres

location
String qui contient le nom du fichier audio.
data
Tableau Byte qui représente le fichier audio.
stream
Tableau Stream qui représente le fichier audio.
playMode
Mode énumération AudioPlayMode pour lire le son. Par défaut, AudioPlayMode.Background.

Exceptions

Les conditions ci-dessous peuvent générer une exception :

data ou stream a la valeur Nothing, ou location est une chaîne vide (ArgumentNullException).
L'argument playMode ne fait pas partie des valeurs énumération AudioPlayMode (InvalidEnumArgumentException).
L'utilisateur n'a pas les autorisations suffisantes pour accéder au fichier nommé par location (IOException).
Le chemin d'accès est incorrect dans location (DirectoryNotFoundException)
Le nom du chemin d'accès dans location est trop long (PathTooLongException).
Il existe une situation d'un niveau de confiance partiel dans laquelle l'utilisateur ne dispose des autorisations nécessaires (SecurityException).

Notes

La méthode Play lit le fichier audio .wav stocké sous forme de fichier dans location, de tableau d'octets dans data ou de flux de données dans stream.

Si la surcharge qui accepte uniquement le paramètre location est utilisée, la méthode Play lit le son en arrière-plan. Sinon, le paramètre playMode détermine le mode de lecture du son.

playMode	Description
AudioPlayMode.Background	Lit le son en arrière-plan. Le code appelant continue à s'exécuter.
AudioPlayMode.BackgroundLoop	Lit le son en arrière-plan jusqu'à ce que la méthode My.Computer.Audio.Stop soit appelée. Le code appelant continue à s'exécuter.
AudioPlayMode.WaitToComplete	Lit le son et attend son exécution avant que le code appelant continue.

L'arrière-plan permet à l'application d'exécuter du code pendant la lecture des sons. Pour plus d'informations, consultez Comment : lire des sons en boucle dans Visual Basic et Comment : lire des sons dans Visual Basic.

Tâches

Le tableau suivant répertorie des exemples de tâches impliquant la méthode My.Computer.Audio.Play.

Pour	Consultez
Lire un son une fois	Comment : lire des sons et attendre qu'ils se terminent dans Visual Basic
Lire un son plusieurs fois	Comment : lire des sons en boucle dans Visual Basic
Lire un son en arrière-plan	Comment : lire des sons dans Visual Basic

Exemple

La méthode My.Computer.Audio.Play lit le son spécifié en arrière-plan lorsque PlayMode.Background est spécifié.

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

Cet exemple de code ne peut s'exécuter que dans une application Windows Forms.

Le nom de fichier doit faire référence à un fichier son .wav présent sur votre système.

Pour simplifier la gestion de vos fichiers audio, pensez à stocker les fichiers comme ressources de l'application. Vous pouvez ensuite accéder aux fichiers par l'intermédiaire de l'objet My.Resources.

Configuration requise

Espace de noms :Microsoft.VisualBasic.Devices

Classe :Audio

Assembly : bibliothèque runtime Visual Basic (dans Microsoft.VisualBasic.dll)

Disponibilité par type de projet

Type de projet	Disponible
Application Windows	Oui
Bibliothèque de classes	Oui
Application console	Oui
Bibliothèque de contrôles Windows	Oui
Bibliothèque de contrôles Web	Non
Service Windows	Oui
Site Web	Non

Autorisations

Les autorisations suivantes peuvent être nécessaires :

Autorisation	Description
FileIOPermission	Contrôle la possibilité d'accéder à des fichiers et à des dossiers. Énumération associée : Unrestricted.
SecurityPermission	Décrit un jeu d'autorisations de sécurité appliquées au code. Énumération associée : ControlThread.