Audio.Play Méthode

Définition

Lit un fichier audio .wav.

Surcharges

Play(String)

Lit un fichier audio .wav.

Play(Byte[], AudioPlayMode)

Lit un fichier audio .wav.

Play(Stream, AudioPlayMode)

Lit un fichier audio .wav.

Play(String, AudioPlayMode)

Lit un fichier audio .wav.

Play(String)

Lit un fichier audio .wav.

public:
 void Play(System::String ^ location);
public void Play (string location);
member this.Play : string -> unit
Public Sub Play (location As String)

Paramètres

location
String

String contenant le nom du fichier audio.

Exceptions

location est une chaîne vide.

L'utilisateur n'a pas les autorisations suffisantes pour accéder au fichier nommé par location.

Le chemin d'accès du fichier est incorrect dans location.

Le nom du chemin d'accès dans location est trop long.

Il existe une situation d'un niveau de confiance partiel dans laquelle l'utilisateur ne dispose des autorisations nécessaires.

Exemples

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

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

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

Le nom de fichier doit référencer un fichier audio .wav sur votre système.

Pour simplifier la gestion de vos fichiers audio, envisagez de stocker les fichiers en tant que ressources d’application. Ils sont ensuite accessibles via l’objet My.Resources .

Remarques

La Play méthode lit le fichier audio .wav stocké sous la forme d’un fichier dans location, en tant que tableau d’octets dans dataou en tant que flux dans stream.

Si la surcharge qui accepte uniquement le location paramètre est utilisée, la Play méthode lit le son en arrière-plan. Sinon, le paramètre détermine la playMode façon dont le son sera lu.

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 Stop méthode soit appelée. Le code appelant continue à s'exécuter.
AudioPlayMode.WaitToComplete Lit le son et attend qu’il se termine avant que le code appelant continue.

Avec la lecture en arrière-plan, l’application peut exécuter du code pendant la lecture d’un son.

Pour plus d’informations, consultez Lecture de sons.

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

Voir aussi

S’applique à

Play(Byte[], AudioPlayMode)

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

Paramètres

data
Byte[]

Tableau Byte qui représente le fichier audio.

playMode
AudioPlayMode

Mode AudioPlayMode pour la lecture du son. Par défaut, AudioPlayMode.Background.

Exceptions

data a la valeur Nothing.

playMode ne fait pas partie des valeurs d'énumération AudioPlayMode.

Il existe une situation d'un niveau de confiance partiel dans laquelle l'utilisateur ne dispose des autorisations nécessaires.

Exemples

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

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

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

Le nom de fichier doit référencer un fichier audio .wav sur votre système.

Pour simplifier la gestion de vos fichiers audio, envisagez de stocker les fichiers en tant que ressources d’application. Ils sont ensuite accessibles via l’objet My.Resources .

Remarques

La Play méthode lit le fichier audio .wav stocké sous la forme d’un fichier dans location, en tant que tableau d’octets dans dataou en tant que flux dans stream.

Si la surcharge qui accepte uniquement le location paramètre est utilisée, la Play méthode lit le son en arrière-plan. Sinon, le paramètre détermine la playMode façon dont le son sera lu.

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 Stop méthode soit appelée. Le code appelant continue à s'exécuter.
AudioPlayMode.WaitToComplete Lit le son et attend qu’il se termine avant que le code appelant continue.

Avec la lecture en arrière-plan, l’application peut exécuter du code pendant la lecture d’un son.

Pour plus d’informations, consultez Lecture de sons.

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

Voir aussi

S’applique à

Play(Stream, AudioPlayMode)

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

Paramètres

stream
Stream

Tableau Stream qui représente le fichier audio.

playMode
AudioPlayMode

Mode AudioPlayMode pour la lecture du son. Par défaut, AudioPlayMode.Background.

Exceptions

stream a la valeur Nothing.

playMode ne fait pas partie des valeurs d'énumération AudioPlayMode.

Il existe une situation d'un niveau de confiance partiel dans laquelle l'utilisateur ne dispose des autorisations nécessaires.

Exemples

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

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

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

Le nom de fichier doit référencer un fichier audio .wav sur votre système.

Pour simplifier la gestion de vos fichiers audio, envisagez de stocker les fichiers en tant que ressources d’application. Ils sont ensuite accessibles via l’objet My.Resources .

Remarques

La Play méthode lit le .wav fichier audio stocké sous la forme d’un fichier dans location, en tant que tableau d’octets dans data, ou en tant que flux dans stream.

Si la surcharge qui prend uniquement le location paramètre est utilisée, la Play méthode lit le son en arrière-plan. Sinon, le paramètre détermine la playMode façon dont le son sera lu.

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 Stop méthode soit appelée. Le code appelant continue à s'exécuter.
AudioPlayMode.WaitToComplete Lit le son et attend qu’il se termine avant que le code appelant continue.

Avec la lecture en arrière-plan, l’application peut exécuter du code pendant la lecture d’un son.

Pour plus d’informations, consultez Lecture de sons.

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

Voir aussi

S’applique à

Play(String, AudioPlayMode)

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

Paramètres

location
String

String contenant le nom du fichier audio.

playMode
AudioPlayMode

Mode AudioPlayMode pour la lecture du son. Par défaut, AudioPlayMode.Background.

Exceptions

location est une chaîne vide.

L'utilisateur n'a pas les autorisations suffisantes pour accéder au fichier nommé par location.

Le chemin d'accès du fichier est incorrect dans location.

Le nom du chemin d'accès dans location est trop long.

playMode ne fait pas partie des valeurs d'énumération AudioPlayMode.

Il existe une situation d'un niveau de confiance partiel dans laquelle l'utilisateur ne dispose des autorisations nécessaires.

Exemples

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

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

Cet exemple de code ne peut s’exécuter qu’au sein d’une application Windows Forms.

Le nom de fichier doit référencer un fichier audio .wav sur votre système.

Pour simplifier la gestion de vos fichiers audio, envisagez de stocker les fichiers en tant que ressources d’application. Ils sont ensuite accessibles via l’objet My.Resources .

Remarques

La Play méthode lit le .wav fichier audio stocké sous la forme d’un fichier dans location, en tant que tableau d’octets dans data, ou en tant que flux dans stream.

Si la surcharge qui prend uniquement le location paramètre est utilisée, la Play méthode lit le son en arrière-plan. Sinon, le paramètre détermine la playMode façon dont le son sera lu.

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 Stop méthode soit appelée. Le code appelant continue à s'exécuter.
AudioPlayMode.WaitToComplete Lit le son et attend qu’il se termine avant que le code appelant continue.

Avec la lecture en arrière-plan, l’application peut exécuter du code pendant la lecture d’un son.

Pour plus d’informations, consultez Lecture de sons.

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

Voir aussi

S’applique à