SoundPlayer.LoadAsync Metódus

Definíció

Névtér:

System.Media

Szerelvény:

System.Windows.Extensions.dll

Csomag:

System.Windows.Extensions v11.0.0-rc.1.26425.128

Forrás:

SoundPlayer.cs

Betölt egy .wav fájlt egy streamből vagy egy webes erőforrásból egy új szál használatával.

public:
 void LoadAsync();

public void LoadAsync();

member this.LoadAsync : unit -> unit

Public Sub LoadAsync ()

Kivételek

TimeoutException

A betöltés során eltelt idő meghaladja a megadott időt ezredmásodpercben.LoadTimeout

FileNotFoundException

A megadott SoundLocation fájl nem található.

Példák

Az alábbi példakód bemutatja, hogy a LoadAsync metódus hogyan tölt be aszinkron módon egy .wav fájlt az SoundPlayer osztály egy példánya számára. Ez a példakód egy nagyobb, az SoundPlayer osztályhoz tartozó példa része.

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

Megjegyzések

Ha egy SoundPlayer .wav fájl betöltésére van konfigurálva egy Stream vagy egy webes erőforrásból, ez a metódus egy új szál használatával kezd betölteni egy .wav fájlt a helyről.

Ez a módszer akkor is aktiválja az LoadCompleted eseményt, amikor a betöltés befejeződött, még akkor is, ha a terhelés nem volt sikeres.

Ha egy SoundPlayer .wav fájl helyi fájlelérési útvonalról való betöltésére van konfigurálva, ez a metódus nem tesz semmit, mert a betöltés elhalasztva lesz, amíg el nem kezdődik a lejátszás.

Az aszinkron betöltéssel kapcsolatos további információkért lásd: Hogyan is: Hang aszinkron betöltése Windows űrlapon.

Ez a metódus a feladatban tárolja az összes olyan nem használati kivételt, amelyet a metódus szinkron megfelelője tud dobni. Ha egy kivételt tárol a visszaadott tevékenységben, akkor a rendszer akkor küldi el a kivételt, amikor a feladatra vár. A használati kivételek(például ArgumentException) továbbra is szinkron módon jelennek meg. A tárolt kivételekről lásd a következő által Load()kiadott kivételeket: .

Lásd még

• Load()
• LoadCompleted
• SoundPlayer osztály áttekintése (Windows Forms)
• Útmutató: Hang aszinkron betöltése Windows-űrlapon