SoundPlayer.LoadAsync Метод

Определение

Пространство имен:

System.Media

Сборка:

System.Windows.Extensions.dll

Пакет:

System.Windows.Extensions v8.0.0

Исходный код:

SoundPlayer.cs

Загружает WAV-файл из потока или веб-ресурса с использованием нового потока.

public:
 void LoadAsync();

public void LoadAsync ();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

Исключения

TimeoutException

Время (в миллисекундах), затраченное на загрузку, превышает время, указанное в свойстве LoadTimeout.

FileNotFoundException

Не удается найти файл, заданный параметром SoundLocation.

Примеры

В следующем примере кода показано использование LoadAsync метода для асинхронной загрузки WAV-файла для использования экземпляром SoundPlayer класса . Этот пример входит в состав более крупного примера использования класса SoundPlayer.

try
{
   
   // Assign the selected file's path to 
   // the SoundPlayer object.  
   player->SoundLocation = this->filepathTextbox->Text;
   
   // Load the .wav file.
   player->LoadAsync();
}
catch ( Exception^ ex ) 
{
   ReportStatus( ex->Message );
}

try
{
    // Assign the selected file's path to 
    // the SoundPlayer object.  
    player.SoundLocation = this.filepathTextbox.Text;

    // Load the .wav file.
    player.LoadAsync();
}
catch (Exception ex)
{
    ReportStatus(ex.Message);
}

Try
    ' Assign the selected file's path to the SoundPlayer object.
    player.SoundLocation = Me.filepathTextbox.Text

    ' Load the .wav file.
    player.LoadAsync()
Catch ex As Exception
    ReportStatus(ex.Message)
End Try

Комментарии

SoundPlayer Если для настроена загрузка WAV-файла из Stream или веб-ресурса, этот метод начинает загрузку WAV-файла из расположения с помощью нового потока.

Этот метод вызывает LoadCompleted событие при завершении загрузки, даже если загрузка не была успешной.

SoundPlayer Если для настроена загрузка WAV-файла из локального пути к файлу, этот метод не выполняет никаких действий, так как загрузка откладывается до начала воспроизведения.

Дополнительные сведения об асинхронной загрузке см. в разделе Практическое руководство. Асинхронная загрузка звука в Windows Form.

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Load().

См. также раздел

• Load()
• LoadCompleted
• Общие сведения о классах SoundPlayer (Windows Forms)
• Практическое руководство. Асинхронная загрузка звука в Windows Forms