Audio.Play メソッド

  • リファレンス

定義

名前空間:
Microsoft.VisualBasic.Devices
アセンブリ:
Microsoft.VisualBasic.dll
アセンブリ:
Microsoft.VisualBasic.Forms.dll

.wav サウンド ファイルを再生します。

オーバーロード

Play(String)

.wav サウンド ファイルを再生します。
Play(Byte[], AudioPlayMode)

.wav サウンド ファイルを再生します。
Play(Stream, AudioPlayMode)

.wav サウンド ファイルを再生します。
Play(String, AudioPlayMode)

.wav サウンド ファイルを再生します。

Play(String)

.wav サウンド ファイルを再生します。

public:
 void Play(System::String ^ location);
public void Play (string location);
member this.Play : string -> unit
Public Sub Play (location As String)

パラメーター

location
String

Stringサウンド ファイルの名前を表す 。

例外

ArgumentNullException

location が空の文字列です。

IOException

ユーザーに location で指定されたファイルにアクセスするための十分なアクセス許可がありません。

DirectoryNotFoundException

location に指定されたファイル パスの形式に誤りがあります。

PathTooLongException

location のパス名が長すぎます。

SecurityException

ユーザーが部分的に信頼されており、必要なアクセス許可を持っていません。

例

メソッドは My.Computer.Audio.Play 、 が指定されている場合 PlayMode.Background に、指定したサウンドをバックグラウンドで再生します。

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

このコード例は、Windows フォーム アプリケーション内でのみ実行できます。

ファイル名は、システム上の.wavサウンド ファイルを参照する必要があります。

サウンド ファイルの管理を簡略化するには、アプリケーション リソースとしてファイルを格納することを検討してください。 その後、 オブジェクトを介して My.Resources アクセスできます。

注釈

メソッドはPlay、 にファイルlocationとして格納された.wavサウンド ファイルを、 のバイト配列として、または のdatastreamストリームとして再生します。

パラメーターのみを受け取るオーバーロードを使用する location 場合、 メソッドは Play バックグラウンドでサウンドを再生します。 それ以外の場合、パラメーターによって playMode サウンドの再生方法が決まります。

playMode [説明]
AudioPlayMode.Background バックグラウンドでサウンドを再生します。 呼び出し元のコードが引き続き実行されます。
AudioPlayMode.BackgroundLoop メソッドが呼び出されるまで、バックグラウンドでサウンドを Stop 再生します。 呼び出し元のコードが引き続き実行されます。
AudioPlayMode.WaitToComplete サウンドを再生し、それが完了するまで待機してから、呼び出し元のコードが続行されます。

バックグラウンド再生により、アプリケーションでサウンドを再生しながら他のコードを実行できます。

詳細については、「サウンドの再生」を参照してください。

プロジェクトの種類別の可用性

プロジェクトの種類 使用可能
Windows アプリケーション はい
クラス ライブラリ はい
コンソール アプリケーション はい
Windows コントロール ライブラリ はい
Web コントロール ライブラリ いいえ
Windows サービス はい
Web サイト いいえ

こちらもご覧ください

適用対象

Play(Byte[], AudioPlayMode)

.wav サウンド ファイルを再生します。

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)

パラメーター

data
Byte[]

サウンド ファイルを表す Byte 配列。

playMode
AudioPlayMode

サウンドの再生モードを表す AudioPlayMode。 既定では、AudioPlayMode.Background になります。

例外

ArgumentNullException

data が Nothingです。

InvalidEnumArgumentException

playMode が AudioPlayMode 列挙値ではありません。

SecurityException

ユーザーが部分的に信頼されており、必要なアクセス許可を持っていません。

例

メソッドは My.Computer.Audio.Play 、 が指定されている場合 PlayMode.Background に、指定したサウンドをバックグラウンドで再生します。

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

このコード例は、Windows フォーム アプリケーション内でのみ実行できます。

ファイル名は、システム上の.wavサウンド ファイルを参照する必要があります。

サウンド ファイルの管理を簡略化するには、アプリケーション リソースとしてファイルを格納することを検討してください。 その後、 オブジェクトを介して My.Resources アクセスできます。

注釈

メソッドはPlay、 にファイルlocationとして格納された.wavサウンド ファイルを、 のバイト配列として、または のdatastreamストリームとして再生します。

パラメーターのみを受け取るオーバーロードを使用する location 場合、 メソッドは Play バックグラウンドでサウンドを再生します。 それ以外の場合、パラメーターによって playMode サウンドの再生方法が決まります。

playMode [説明]
AudioPlayMode.Background バックグラウンドでサウンドを再生します。 呼び出し元のコードが引き続き実行されます。
AudioPlayMode.BackgroundLoop メソッドが呼び出されるまで、バックグラウンドでサウンドを Stop 再生します。 呼び出し元のコードが引き続き実行されます。
AudioPlayMode.WaitToComplete サウンドを再生し、それが完了するまで待機してから、呼び出し元のコードが続行されます。

バックグラウンド再生により、アプリケーションでサウンドを再生しながら他のコードを実行できます。

詳細については、「サウンドの再生」を参照してください。

プロジェクトの種類別の可用性

プロジェクトの種類 使用可能
Windows アプリケーション はい
クラス ライブラリ はい
コンソール アプリケーション はい
Windows コントロール ライブラリ はい
Web コントロール ライブラリ いいえ
Windows サービス はい
Web サイト いいえ

こちらもご覧ください

適用対象

Play(Stream, AudioPlayMode)

.wav サウンド ファイルを再生します。

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)

パラメーター

stream
Stream

サウンド ファイルを表す Stream。

playMode
AudioPlayMode

サウンドの再生モードを表す AudioPlayMode。 既定では、AudioPlayMode.Background になります。

例外

ArgumentNullException

stream が Nothingです。

InvalidEnumArgumentException

playMode が AudioPlayMode 列挙値ではありません。

SecurityException

ユーザーが部分的に信頼されており、必要なアクセス許可を持っていません。

例

メソッドは My.Computer.Audio.Play 、 が指定されている場合 PlayMode.Background に、指定したサウンドをバックグラウンドで再生します。

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

このコード例は、Windows フォーム アプリケーション内でのみ実行できます。

ファイル名は、システム上の.wavサウンド ファイルを参照する必要があります。

サウンド ファイルの管理を簡略化するには、アプリケーション リソースとしてファイルを格納することを検討してください。 その後、 オブジェクトを介して My.Resources アクセスできます。

注釈

メソッドはPlay、 にファイルlocationとして格納された.wavサウンド ファイルを、 のバイト配列として、または のdatastreamストリームとして再生します。

パラメーターのみを受け取るオーバーロードを使用する location 場合、 メソッドは Play バックグラウンドでサウンドを再生します。 それ以外の場合、パラメーターによって playMode サウンドの再生方法が決まります。

playMode [説明]
AudioPlayMode.Background バックグラウンドでサウンドを再生します。 呼び出し元のコードが引き続き実行されます。
AudioPlayMode.BackgroundLoop メソッドが呼び出されるまで、バックグラウンドでサウンドを Stop 再生します。 呼び出し元のコードが引き続き実行されます。
AudioPlayMode.WaitToComplete サウンドを再生し、それが完了するまで待機してから、呼び出し元のコードが続行されます。

バックグラウンド再生により、アプリケーションでサウンドを再生しながら他のコードを実行できます。

詳細については、「サウンドの再生」を参照してください。

プロジェクトの種類別の可用性

プロジェクトの種類 使用可能
Windows アプリケーション はい
クラス ライブラリ はい
コンソール アプリケーション はい
Windows コントロール ライブラリ はい
Web コントロール ライブラリ いいえ
Windows サービス はい
Web サイト いいえ

こちらもご覧ください

適用対象

Play(String, AudioPlayMode)

.wav サウンド ファイルを再生します。

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)

パラメーター

location
String

Stringサウンド ファイルの名前を表す 。

playMode
AudioPlayMode

サウンドの再生モードを表す AudioPlayMode。 既定では、AudioPlayMode.Background になります。

例外

ArgumentNullException

location が空の文字列です。

IOException

ユーザーに location で指定されたファイルにアクセスするための十分なアクセス許可がありません。

DirectoryNotFoundException

location に指定されたファイル パスの形式に誤りがあります。

PathTooLongException

location のパス名が長すぎます。

InvalidEnumArgumentException

playMode が AudioPlayMode 列挙値ではありません。

SecurityException

ユーザーが部分的に信頼されており、必要なアクセス許可を持っていません。

例

メソッドは My.Computer.Audio.Play 、 が指定されている場合 PlayMode.Background に、指定したサウンドをバックグラウンドで再生します。

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

このコード例は、Windows フォーム アプリケーション内でのみ実行できます。

ファイル名は、システム上の.wavサウンド ファイルを参照する必要があります。

サウンド ファイルの管理を簡略化するには、アプリケーション リソースとしてファイルを格納することを検討してください。 その後、 オブジェクトを介して My.Resources アクセスできます。

注釈

メソッドはPlay、 にファイルlocationとして格納された.wavサウンド ファイルを、 のバイト配列として、または のdatastreamストリームとして再生します。

パラメーターのみを受け取るオーバーロードを使用する location 場合、 メソッドは Play バックグラウンドでサウンドを再生します。 それ以外の場合、パラメーターによって playMode サウンドの再生方法が決まります。

playMode [説明]
AudioPlayMode.Background バックグラウンドでサウンドを再生します。 呼び出し元のコードが引き続き実行されます。
AudioPlayMode.BackgroundLoop メソッドが呼び出されるまで、バックグラウンドでサウンドを Stop 再生します。 呼び出し元のコードが引き続き実行されます。
AudioPlayMode.WaitToComplete サウンドを再生し、それが完了するまで待機してから、呼び出し元のコードが続行されます。

バックグラウンド再生により、アプリケーションでサウンドを再生しながら他のコードを実行できます。

詳細については、「サウンドの再生」を参照してください。

プロジェクトの種類別の可用性

プロジェクトの種類 使用可能
Windows アプリケーション はい
クラス ライブラリ はい
コンソール アプリケーション はい
Windows コントロール ライブラリ はい
Web コントロール ライブラリ いいえ
Windows サービス はい
Web サイト いいえ

こちらもご覧ください

適用対象