SoundPlayer.LoadAsync Método

Definição

Namespace:

System.Media

Assembly:

System.Windows.Extensions.dll

Pacote:

System.Windows.Extensions v8.0.0

Origem:

SoundPlayer.cs

Carrega um arquivo .wav de um fluxo ou um recurso da Web usando um novo thread.

public:
 void LoadAsync();

public void LoadAsync ();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

Exceções

TimeoutException

O tempo decorrido durante o carregamento excede o tempo, em milissegundos, especificado por LoadTimeout.

FileNotFoundException

O arquivo especificado por SoundLocation não foi encontrado.

Exemplos

O exemplo de código a seguir demonstra o uso do LoadAsync método para carregar de forma assíncrona um arquivo .wav para uso por uma instância da SoundPlayer classe . Este exemplo de código faz parte de um exemplo maior fornecido para a SoundPlayer classe .

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

Comentários

Se um SoundPlayer estiver configurado para carregar um arquivo .wav de um Stream recurso da Web ou , esse método começará a carregar um arquivo .wav do local usando um novo thread.

Esse método aciona o evento quando o LoadCompleted carregamento é concluído, mesmo que a carga não tenha sido bem-sucedida.

Se um SoundPlayer estiver configurado para carregar um arquivo .wav de um caminho de arquivo local, esse método não fará nada, pois o carregamento será adiado até que a reprodução seja iniciada.

Para obter mais informações sobre o carregamento assíncrono, consulte Como carregar um som de forma assíncrona em um Windows Form.

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Load().

Confira também

• Load()
• LoadCompleted
• Visão geral da classe SoundPlayer (Windows Forms)
• Como: Carregar um som de forma assíncrona dentro de um Windows Form