Audio.Play Methode

Definition

Namespace:

Microsoft.VisualBasic.Devices

Assembly:

Microsoft.VisualBasic.Forms.dll

Gibt eine WAV-Audiodatei wieder.

Überlädt

Play(String)	Gibt eine WAV-Audiodatei wieder.
Play(Byte[], AudioPlayMode)	Gibt eine WAV-Audiodatei wieder.
Play(Stream, AudioPlayMode)	Gibt eine WAV-Audiodatei wieder.
Play(String, AudioPlayMode)	Gibt eine WAV-Audiodatei wieder.

Play(String)

Gibt eine WAV-Audiodatei wieder.

public:
 void Play(System::String ^ location);

public void Play (string location);

member this.Play : string -> unit

Public Sub Play (location As String)

Parameter

location

String

Ein String , der den Namen der Sounddatei enthält.

Ausnahmen

ArgumentNullException

location ist eine leere Zeichenfolge.

IOException

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

DirectoryNotFoundException

Der Dateipfad in location ist falsch formatiert.

PathTooLongException

Der Pfadname in location ist zu lang.

SecurityException

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

Beispiele

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

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

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

Der Dateiname sollte auf eine .wav Sounddatei auf Ihrem System verweisen.

Um die Verwaltung Ihrer Sounddateien zu vereinfachen, sollten Sie die Dateien als Anwendungsressourcen speichern. Auf sie kann dann über das My.Resources -Objekt zugegriffen werden.

Hinweise

Die Play -Methode gibt die .wav Sounddatei wieder, die als Datei unter locationgespeichert ist, als Bytearray in dataoder als Stream in stream.

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

playMode	BESCHREIBUNG
AudioPlayMode.Background	Gibt den Sound im Hintergrund ab. Der aufrufende Code wird weiterhin ausgeführt.
AudioPlayMode.BackgroundLoop	Gibt den Sound im Hintergrund ab, bis die Stop Methode aufgerufen wird. Der aufrufende Code wird weiterhin ausgeführt.
AudioPlayMode.WaitToComplete	Gibt den Sound ab und wartet, bis er abgeschlossen ist, bevor der aufrufende Code fortgesetzt wird.

Die Wiedergabe im Hintergrund lässt die Anwendung einen anderen Code ausführen, während der Sound wiedergegeben wird.

Weitere Informationen finden Sie unter Wiedergeben von Sounds.

Verfügbarkeit nach Projekttyp

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

Weitere Informationen

• Stop()
• AudioPlayMode
• Objekte (Visual Basic)
• Wiedergabe von Sound (Visual Basic)

Play(Byte[], AudioPlayMode)

Gibt eine WAV-Audiodatei wieder.

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)

Parameter

data

Byte[]

Byte-Array, das die Audiodatei darstellt.

playMode

AudioPlayMode

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

Ausnahmen

ArgumentNullException

data ist Nothing.

InvalidEnumArgumentException

playMode ist keiner der AudioPlayMode-Enumerationswerte.

SecurityException

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

Beispiele

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

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

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

Der Dateiname sollte auf eine .wav Sounddatei auf Ihrem System verweisen.

Um die Verwaltung Ihrer Sounddateien zu vereinfachen, sollten Sie die Dateien als Anwendungsressourcen speichern. Auf sie kann dann über das My.Resources -Objekt zugegriffen werden.

Hinweise

Die Play -Methode gibt die .wav Sounddatei wieder, die als Datei unter locationgespeichert ist, als Bytearray in dataoder als Stream in stream.

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

playMode	BESCHREIBUNG
AudioPlayMode.Background	Gibt den Sound im Hintergrund ab. Der aufrufende Code wird weiterhin ausgeführt.
AudioPlayMode.BackgroundLoop	Gibt den Sound im Hintergrund ab, bis die Stop Methode aufgerufen wird. Der aufrufende Code wird weiterhin ausgeführt.
AudioPlayMode.WaitToComplete	Gibt den Sound ab und wartet, bis er abgeschlossen ist, bevor der aufrufende Code fortgesetzt wird.

Die Wiedergabe im Hintergrund lässt die Anwendung einen anderen Code ausführen, während der Sound wiedergegeben wird.

Weitere Informationen finden Sie unter Wiedergeben von Sounds.

Verfügbarkeit nach Projekttyp

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

Weitere Informationen

• Stop()
• AudioPlayMode
• Objekte (Visual Basic)
• Wiedergabe von Sound (Visual Basic)

Play(Stream, AudioPlayMode)

Gibt eine WAV-Audiodatei wieder.

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)

Parameter

stream

Stream

Stream, der die Audiodatei darstellt.

playMode

AudioPlayMode

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

Ausnahmen

ArgumentNullException

stream ist Nothing.

InvalidEnumArgumentException

playMode ist keiner der AudioPlayMode-Enumerationswerte.

SecurityException

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

Beispiele

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

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

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

Der Dateiname sollte auf eine .wav Sounddatei auf Ihrem System verweisen.

Um die Verwaltung Ihrer Sounddateien zu vereinfachen, sollten Sie die Dateien als Anwendungsressourcen speichern. Auf sie kann dann über das My.Resources -Objekt zugegriffen werden.

Hinweise

Die Play -Methode gibt die .wav Audiodatei wieder, die als Datei unter locationgespeichert ist, als Bytearray in dataoder als Stream in stream.

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 weiterhin ausgeführt.
AudioPlayMode.BackgroundLoop	Gibt den Sound im Hintergrund wieder, bis die Stop -Methode aufgerufen wird. Der aufrufende Code wird weiterhin ausgeführt.
AudioPlayMode.WaitToComplete	Gibt den Sound wieder und wartet, bis er abgeschlossen ist, bevor der aufrufende Code fortgesetzt wird.

Die Wiedergabe im Hintergrund lässt die Anwendung einen anderen Code ausführen, während der Sound wiedergegeben wird.

Weitere Informationen finden Sie unter Wiedergeben von Sounds.

Verfügbarkeit nach Projekttyp

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

Weitere Informationen

• Stop()
• AudioPlayMode
• Stream
• Objekte (Visual Basic)
• Wiedergabe von Sound (Visual Basic)

Play(String, AudioPlayMode)

Gibt eine WAV-Audiodatei wieder.

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)

Parameter

location

String

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

playMode

AudioPlayMode

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

Ausnahmen

ArgumentNullException

location ist eine leere Zeichenfolge.

IOException

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

DirectoryNotFoundException

Der Dateipfad in location ist falsch formatiert.

PathTooLongException

Der Pfadname in location ist zu lang.

InvalidEnumArgumentException

playMode ist keiner der AudioPlayMode-Enumerationswerte.

SecurityException

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

Beispiele

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.WaitToComplete)
End Sub

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

Der Dateiname sollte auf eine .wav Sounddatei auf Ihrem System verweisen.

Um die Verwaltung Ihrer Sounddateien zu vereinfachen, sollten Sie die Dateien als Anwendungsressourcen speichern. Auf sie kann dann über das My.Resources -Objekt zugegriffen werden.

Hinweise

Die Play -Methode gibt die .wav Audiodatei wieder, die als Datei unter locationgespeichert ist, als Bytearray in dataoder als Stream in stream.

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 weiterhin ausgeführt.
AudioPlayMode.BackgroundLoop	Gibt den Sound im Hintergrund wieder, bis die Stop -Methode aufgerufen wird. Der aufrufende Code wird weiterhin ausgeführt.
AudioPlayMode.WaitToComplete	Gibt den Sound wieder und wartet, bis er abgeschlossen ist, bevor der aufrufende Code fortgesetzt wird.

Die Wiedergabe im Hintergrund lässt die Anwendung einen anderen Code ausführen, während der Sound wiedergegeben wird.

Weitere Informationen finden Sie unter Wiedergeben von Sounds.

Verfügbarkeit nach Projekttyp

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

Weitere Informationen

• Stop()
• AudioPlayMode
• Objekte (Visual Basic)
• Wiedergabe von Sound (Visual Basic)