Audio.Play Methode

Definition

Namespace:
Microsoft.VisualBasic.Devices
Assembly:
Microsoft.VisualBasic.dll

Gibt eine .wav Sounddatei wieder.

Überlädt

Name Beschreibung
Play(String)

Gibt eine .wav Sounddatei wieder.
Play(Byte[], AudioPlayMode)

Gibt eine .wav Sounddatei wieder.
Play(Stream, AudioPlayMode)

Gibt eine .wav Sounddatei wieder.
Play(String, AudioPlayMode)

Gibt eine .wav Sounddatei wieder.

Play(String)

Gibt eine .wav Sounddatei 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

A String mit dem Namen der Audiodatei.

Ausnahmen

ArgumentNullException

location ist eine leere Zeichenfolge.

IOException

Der Benutzer verfügt nicht über ausreichende Berechtigungen, um auf die Datei zuzugreifen, die von location.

DirectoryNotFoundException

Der Dateipfad ist falsch formatiert in location.

PathTooLongException

Der Pfadname ist location zu lang.

SecurityException

Eine teilweise vertrauenswürdige Situation ist vorhanden, in der der Benutzer ü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

In diesem 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 Audiodateien zu vereinfachen, sollten Sie die Dateien als Anwendungsressourcen speichern. Sie können dann über das My.Resources Objekt zugegriffen werden.

Hinweise

Die Play Methode gibt die .wav Audiodatei wieder, die als Datei bei location, als Bytearray in dataoder als Datenstrom gespeichert streamist.

Wenn die Überladung, die nur den location Parameter verwendet, verwendet wird, 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 Hintergrundwiedergabe ermöglicht es der Anwendung, anderen Code auszuführen, während der Sound wiedergegeben wird.

Weitere Informationen finden Sie unter Wiedergeben von Sounds.

Verfügbarkeit nach Projekttyp

Projekttyp Available
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 Sounddatei 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 Wiedergabe des Sounds. Standardmäßig ist dies AudioPlayMode.Background.

Ausnahmen

ArgumentNullException

data ist Nothing.

InvalidEnumArgumentException

playMode ist keine der AudioPlayMode Enumerationswerte.

SecurityException

Eine teilweise vertrauenswürdige Situation ist vorhanden, in der der Benutzer ü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

In diesem 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 Audiodateien zu vereinfachen, sollten Sie die Dateien als Anwendungsressourcen speichern. Sie können dann über das My.Resources Objekt zugegriffen werden.

Hinweise

Die Play Methode gibt die .wav Audiodatei wieder, die als Datei bei location, als Bytearray in dataoder als Datenstrom gespeichert streamist.

Wenn die Überladung, die nur den location Parameter verwendet, verwendet wird, 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 Hintergrundwiedergabe ermöglicht es der Anwendung, anderen Code auszuführen, während der Sound wiedergegeben wird.

Weitere Informationen finden Sie unter Wiedergeben von Sounds.

Verfügbarkeit nach Projekttyp

Projekttyp Available
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 Sounddatei 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 das die Audiodatei darstellt.

playMode
AudioPlayMode

AudioPlayMode modus für die Wiedergabe des Sounds. Standardmäßig ist dies AudioPlayMode.Background.

Ausnahmen

ArgumentNullException

stream ist Nothing.

InvalidEnumArgumentException

playMode ist keine der AudioPlayMode Enumerationswerte.

SecurityException

Eine teilweise vertrauenswürdige Situation ist vorhanden, in der der Benutzer ü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

In diesem 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 Audiodateien zu vereinfachen, sollten Sie die Dateien als Anwendungsressourcen speichern. Sie können dann über das My.Resources Objekt zugegriffen werden.

Hinweise

Die Play Methode gibt die .wav Audiodatei wieder, die als Datei bei location, als Bytearray in dataoder als Datenstrom gespeichert streamist.

Wenn die Überladung, die nur den location Parameter verwendet, verwendet wird, 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 Hintergrundwiedergabe ermöglicht es der Anwendung, anderen Code auszuführen, während der Sound wiedergegeben wird.

Weitere Informationen finden Sie unter Wiedergeben von Sounds.

Verfügbarkeit nach Projekttyp

Projekttyp Available
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 Sounddatei 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

A String mit dem Namen der Audiodatei.

playMode
AudioPlayMode

AudioPlayMode modus für die Wiedergabe des Sounds. Standardmäßig ist dies AudioPlayMode.Background.

Ausnahmen

ArgumentNullException

location ist eine leere Zeichenfolge.

IOException

Der Benutzer verfügt nicht über ausreichende Berechtigungen, um auf die Datei zuzugreifen, die von location.

DirectoryNotFoundException

Der Dateipfad ist falsch formatiert in location.

PathTooLongException

Der Pfadname ist location zu lang.

InvalidEnumArgumentException

playMode ist keine der AudioPlayMode Enumerationswerte.

SecurityException

Eine teilweise vertrauenswürdige Situation ist vorhanden, in der der Benutzer ü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

In diesem 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 Audiodateien zu vereinfachen, sollten Sie die Dateien als Anwendungsressourcen speichern. Sie können dann über das My.Resources Objekt zugegriffen werden.

Hinweise

Die Play Methode gibt die .wav Audiodatei wieder, die als Datei bei location, als Bytearray in dataoder als Datenstrom gespeichert streamist.

Wenn die Überladung, die nur den location Parameter verwendet, verwendet wird, 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 Hintergrundwiedergabe ermöglicht es der Anwendung, anderen Code auszuführen, während der Sound wiedergegeben wird.

Weitere Informationen finden Sie unter Wiedergeben von Sounds.

Verfügbarkeit nach Projekttyp

Projekttyp Available
Windows-Anwendung Ja
Klassenbibliothek Ja
Konsolenanwendung Ja
Windows-Steuerelementbibliothek Ja
Websteuerelementbibliothek Nein
Windows-Dienst Ja
Website Nein

Weitere Informationen

Gilt für: