Audio.Play Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic.Devices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Gilt für:

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.

`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

Gilt für:

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

Gilt für:

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.

`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

Gilt für:

Freigeben über

Audio.Play Methode

Definition

Überlädt

Play(String)

Parameter

Ausnahmen

Beispiele

Hinweise

Verfügbarkeit nach Projekttyp

Weitere Informationen

Gilt für:

Play(Byte[], AudioPlayMode)

Parameter

Ausnahmen

Beispiele

Hinweise

Verfügbarkeit nach Projekttyp

Weitere Informationen

Gilt für:

Play(Stream, AudioPlayMode)

Parameter

Ausnahmen

Beispiele

Hinweise

Verfügbarkeit nach Projekttyp

Weitere Informationen

Gilt für:

Play(String, AudioPlayMode)

Parameter

Ausnahmen

Beispiele

Hinweise

Verfügbarkeit nach Projekttyp

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen