Freigeben über


Audio.Play Methode

Definition

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

location ist eine leere Zeichenfolge.

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

Der Dateipfad in location ist falsch formatiert.

Der Pfadname in location ist zu lang.

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

data ist Nothing.

playMode ist keiner der AudioPlayMode-Enumerationswerte.

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(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

stream ist Nothing.

playMode ist keiner der AudioPlayMode-Enumerationswerte.

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

location ist eine leere Zeichenfolge.

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

Der Dateipfad in location ist falsch formatiert.

Der Pfadname in location ist zu lang.

playMode ist keiner der AudioPlayMode-Enumerationswerte.

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

Gilt für: