My.Computer.Audio.Play-Methode

Aktualisiert: November 2007

Gibt eine WAV-Audiodatei wieder.

' 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 _
)

Parameter

• location
  Ein String, der den Namen der Audiodatei enthält.

• data
  Byte-Array, das die Audiodatei darstellt.

• stream
  Stream, der die Audiodatei darstellt.

• playMode
  AudioPlayMode-Enumeration-Modus für die Soundwiedergabe. Standardmäßig AudioPlayMode.Background.

Ausnahmen

Die folgenden Bedingungen können einen Ausnahmefehler verursachen:

• data oder stream ist Nothing, oder location ist eine leere Zeichenfolge (ArgumentNullException).

• Das playMode-Argument ist kein AudioPlayMode-Enumeration-Wert (InvalidEnumArgumentException).

• Der Benutzer verfügt nicht über ausreichende Berechtigungen für den Zugriff auf die durch location angegebene Datei (IOException).

• Der Dateipfad in location ist falsch formatiert (DirectoryNotFoundException).

• Der Pfadname in location ist zu lang (PathTooLongException).

• Ein teilweise vertrauenswürdiger Kontext, in dem der Benutzer nicht über erforderliche Berechtigungen verfügt (SecurityException).

Hinweise

Die Play-Methode gibt die WAV-Audiodatei mit location als gespeicherte Datei, mit data als Bytearray und mit stream als Stream wieder.

Wenn die Überladung verwendet wird, die nur den location-Parameter akzeptiert, gibt die Play-Methode den Sound im Hintergrund wieder. Andernfalls bestimmt der playMode-Parameter, wie der Sound wiedergegeben wird.

Bei der Soundwiedergabe im Hintergrund führt die Anwendung anderen Code aus, während der Sound wiedergegeben wird. Weitere Informationen finden Sie unter Gewusst wie: Wiedergeben von Soundschleifen in Visual Basic und unter Gewusst wie: Wiedergeben von Sounds in Visual Basic.

Aufgaben

In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.Audio.Play-Methode aufgeführt.

Beispiel

Die My.Computer.Audio.Play-Methode gibt den angegebenen Sound im Hintergrund wieder, wenn PlayMode.Background angegeben wird.

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

Dieses Codebeispiel kann nur in einer Windows Forms-Anwendung ausgeführt werden.

Der Dateiname sollte auf eine WAV-Audiodatei in Ihrem System verweisen.

Speichern Sie Audiodateien als Anwendungsressourcen, um ihre Verwaltung zu vereinfachen. Der Zugriff auf die Dateien kann dann über das My.Resources-Objekt erfolgen.

Anforderungen

Namespace: Microsoft.VisualBasic.Devices

Klasse: Audio

Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)

Verfügbarkeit nach Projekttyp

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.

Siehe auch

Aufgaben

Gewusst wie: Wiedergabe eines Sounds und Warten auf den Abschluss der Wiedergabe in Visual Basic

Gewusst wie: Wiedergeben von Soundschleifen in Visual Basic

Gewusst wie: Wiedergeben von Sounds in Visual Basic

Referenz

My.Computer.Audio-Objekt

My.Computer.Audio.Stop-Methode

AudioPlayMode-Enumeration

System.IO.Stream

Audio.Play