My.Computer.Audio.Play-Methode

Artikel
08/20/2008

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.

playMode	Beschreibung
AudioPlayMode.Background	Gibt den Sound im Hintergrund wieder. Der aufrufende Code wird weiter ausgeführt.
AudioPlayMode.BackgroundLoop	Gibt den Sound im Hintergrund wieder, bis die My.Computer.Audio.Stop-Methode aufgerufen wird. Der aufrufende Code wird weiter ausgeführt.
AudioPlayMode.WaitToComplete	Gibt den Sound wieder und setzt die Ausführung des aufrufenden Codes erst nach Abschluss der Wiedergabe fort.

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.

Zweck	Weitere Informationen finden Sie unter
Einmalige Wiedergabe eines Sounds	Gewusst wie: Wiedergabe eines Sounds und Warten auf den Abschluss der Wiedergabe in Visual Basic
Mehrfache Wiedergabe eines Sounds	Gewusst wie: Wiedergeben von Soundschleifen in Visual Basic
Wiedergabe eines Sounds im Hintergrund	Gewusst wie: Wiedergeben von Sounds in Visual Basic

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

Projekttyp	Verfügbar
Windows-Anwendung	Ja
Klassenbibliothek	Ja
Konsolenanwendung	Ja
Windows-Steuerelementbibliothek	Ja
Web-Steuerelementbibliothek	Nein
Windows-Dienst	Ja
Website	Nein

Berechtigungen

Die folgenden Berechtigungen sind möglicherweise erforderlich:

Berechtigung	Beschreibung
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
SecurityPermission	Beschreibt einen Satz von Sicherheitsberechtigungen, die auf Code angewendet werden. Zugeordnete Enumeration: ControlThread.