SoundPlayer.LoadAsync Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Läser in en .wav fil från en dataström eller en webbresurs med hjälp av en ny tråd.
public:
void LoadAsync();
public void LoadAsync();
member this.LoadAsync : unit -> unit
Public Sub LoadAsync ()
Undantag
Den förflutna tiden under inläsningen överskrider den tid i millisekunder som anges av LoadTimeout.
Det går inte att hitta filen som anges av SoundLocation .
Exempel
I följande kodexempel visas hur metoden används LoadAsync för att asynkront läsa in en .wav fil för användning av en instans av SoundPlayer klassen. Det här kodexemplet är en del av ett större exempel för SoundPlayer klassen.
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
Kommentarer
Om en SoundPlayer har konfigurerats för att läsa in en .wav fil från en eller en Stream webbresurs börjar den här metoden läsa in en .wav fil från platsen med hjälp av en ny tråd.
Den här metoden genererar LoadCompleted händelsen när inläsningen slutförs, även om belastningen inte lyckades.
Om en SoundPlayer har konfigurerats för att läsa in en .wav fil från en lokal filsökväg gör den här metoden ingenting, eftersom inläsningen skjuts upp tills uppspelningen börjar.
Mer information om asynkron inläsning finns i How to: Load a Sound Asynchronously within a Windows Form.
Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Load().