SoundPlayer.Play メソッド

定義

新しいスレッドを使用して .wav ファイルを再生します。 .wav ファイルが読み込まれていない場合は、まずそのファイルを読み込みます。Plays the .wav file using a new thread, and loads the .wav file first if it has not been loaded.

public:
 void Play();
public void Play ();
member this.Play : unit -> unit
Public Sub Play ()

例外

読み込み時の経過時間が、LoadTimeout で指定された時間 (ミリ秒単位) を超過しました。The elapsed time during loading exceeds the time, in milliseconds, specified by LoadTimeout.

SoundLocation で指定したファイルが見つかりません。The file specified by SoundLocation cannot be found.

.wav ヘッダーが破損しています。SoundLocation で指定したファイルは、PCM .wav ファイルではありません。The .wav header is corrupted; the file specified by SoundLocation is not a PCM .wav file.

次のコード例は、 Playメソッドを使用して、.wav ファイルを非同期に再生する方法を示しています。The following code example demonstrates the use of the Play method to asynchronously play a .wav file. このコード例は、 SoundPlayerクラスに対して提供される大規模な例の一部です。This code example is part of a larger example provided for the SoundPlayer class.

ReportStatus( "Playing .wav file asynchronously." );
player->Play();

ReportStatus("Playing .wav file asynchronously.");
player.Play();
ReportStatus("Playing .wav file asynchronously.")
player.Play()

注釈

メソッドPlayは、新しいスレッドを使用してサウンドを再生します。The Play method plays the sound using a new thread. .Wav ファイルがPlayメモリに読み込まれる前にを呼び出すと、再生が開始される前に .wav ファイルが読み込まれます。If you call Play before the .wav file has been loaded into memory, the .wav file will be loaded before playback starts. LoadAsyncまたはLoadメソッドを使用して、.wav ファイルを事前にメモリに読み込むことができます。You can use the LoadAsync or Load method to load the .wav file to memory in advance. .Wav ファイルがStreamまたは URL から正常に読み込まれた後、の再生メソッドSoundPlayerを呼び出すと、サウンドのパスが変更されるまで .wav ファイルを再読み込みする必要がなくなります。After a .wav file is successfully loaded from a Stream or URL, future calls to playback methods for the SoundPlayer will not need to reload the .wav file until the path for the sound changes.

.Wav ファイルが指定されていない場合、または読み込みに失敗Playした場合、メソッドは既定のビープ音を再生します。If the .wav file has not been specified or it fails to load, the Play method will play the default beep sound.

セキュリティ

FileIOPermission
ファイルの読み取りに使用します。for reading files. 関連付けられた列挙型:ReadAssociated enumeration: Read

UIPermission
ネイティブコードへのアクセスに使用します。for access to native code. 関連付けられた列挙型:SafeSubWindowsAssociated enumeration: SafeSubWindows

適用対象

こちらもご覧ください