SoundPlayer.LoadAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Carrega um ficheiro .wav a partir de um stream ou de um recurso Web usando um novo thread.
public:
void LoadAsync();
public void LoadAsync();
member this.LoadAsync : unit -> unit
Public Sub LoadAsync ()
Exceções
O tempo decorrido durante o carregamento excede o tempo, em milissegundos, especificado por LoadTimeout.
O ficheiro especificado por SoundLocation não pode ser encontrado.
Exemplos
O exemplo de código seguinte demonstra o uso do LoadAsync método para carregar assíncronamente um ficheiro de .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
Observações
Se a SoundPlayer estiver configurado para carregar um ficheiro .wav a partir de um Stream ou recurso Web, este método começa a carregar um ficheiro .wav a partir da localização usando uma nova thread.
Este método levanta o LoadCompleted evento quando o carregamento termina, mesmo que o carregamento não tenha sido bem-sucedido.
Se a SoundPlayer estiver configurado para carregar um ficheiro .wav a partir de um caminho local, este método não faz nada, porque o carregamento é adiado até o início da reprodução.
Para mais informações sobre carregamento assíncrono, veja Como: Carregar um Som Assíncrono dentro de uma Windows Forma.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Load().