My.Computer.Audio.Play メソッド

更新 : 2007 年 11 月

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

' Usage
My.Computer.Audio.Play(location)
My.Computer.Audio.Play(location ,playMode)
My.Computer.Audio.Play(data ,playMode)
My.Computer.Audio.Play(stream ,playMode)
' Declaration
Public Sub Play( _
   ByVal location As String _
)
' -or-
Public Sub Play( _
   ByVal location As String, _
   ByVal playMode As AudioPlayMode _
)
' -or-
Public Sub Play( _
   ByVal data As Byte(), _
   ByVal playMode As AudioPlayMode _
)
' -or-
Public Sub Play( _
   ByVal stream As System.IO.Stream, _
   ByVal playMode As AudioPlayMode _
)

パラメータ

• location
  サウンド ファイルの名前を含む String。

• data
  サウンド ファイルを表現する Byte 配列。

• stream
  サウンド ファイルを表現する Stream。

• playMode
  サウンドの再生モードである AudioPlayMode 列挙型。既定では AudioPlayMode.Background です。

例外

例外を引き起こす可能性のある状態を次に示します。

• data または stream が Nothing であるか、location が空の文字列です (ArgumentNullException)。

• playMode 引数が AudioPlayMode 列挙型 のいずれかの値ではありません (InvalidEnumArgumentException)。

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

• location に指定されたファイル パスの形式が誤っています (DirectoryNotFoundException)。

• location のパス名が長すぎます (PathTooLongException))。

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

解説

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

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

バックグラウンド再生を利用すると、サウンドの再生中にアプリケーションで他のコードを実行できます。詳細については、「方法 : Visual Basic でループ サウンドを再生する」および「方法 : Visual Basic でサウンドを再生する」を参照してください。

処理手順

My.Computer.Audio.Play メソッドに関連するタスクの例を次の表に示します。

使用例

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

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

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

ファイル名は、使用中のシステムに置かれた .wav サウンド ファイルの名前であることが必要です。

サウンド ファイルを簡単に管理するために、アプリケーション リソースとして格納することをお勧めします。それにより、My.Resources オブジェクト を使ってファイルにアクセスできるようになります。

必要条件

名前空間 : Microsoft.VisualBasic.Devices

クラス : Audio

アセンブリ : Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll 内)

使用可能なプロジェクトの種類

アクセス許可

次のアクセス許可が必要になる可能性があります。

詳細については、「コード アクセス セキュリティ」および「アクセス許可の要求」を参照してください。

参照

処理手順

方法 : Visual Basic でサウンドを再生し、完了まで待機する

方法 : Visual Basic でループ サウンドを再生する

方法 : Visual Basic でサウンドを再生する

参照

My.Computer.Audio オブジェクト

My.Computer.Audio.Stop メソッド

AudioPlayMode 列挙型

System.IO.Stream

Audio.Play