Freigeben über


SoundPlayer.Load Methode

Definition

Lädt einen Sound synchron.

public:
 void Load();
public void Load ();
member this.Load : unit -> unit
Public Sub Load ()

Ausnahmen

Die beim Ladevorgang verstrichene Zeit übersteigt die vom LoadTimeout angegebene Zeitspanne (in Millisekunden).

Die durch SoundLocation angegebene Datei kann nicht gefunden werden.

Beispiele

Das folgende Codebeispiel veranschaulicht die Verwendung der LoadAsync -Methode zum Anfügen einer .wav-Datei an eine instance der SoundPlayer -Klasse. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die SoundPlayer-Klasse bereitgestellt wird.

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

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

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

Hinweise

Die Load -Methode verwendet den aktuellen Thread, um eine .wav-Datei zu laden, wodurch verhindert wird, dass der Thread andere Nachrichten verarbeitet, bis der Ladevorgang abgeschlossen ist.

Achtung

Die Load -Methode kann beim Laden einer großen .wav-Datei zu einer Verzögerung führen. Außerdem werden malen und andere Ereignisse blockiert, bis der Ladevorgang abgeschlossen ist. Verwenden Sie die LoadAsync -Methode, um einen Sound asynchron zu laden, sodass der aufrufende Thread ohne Unterbrechung fortgesetzt werden kann.

Diese Methode löst das -Ereignis aus, wenn der LoadCompleted Ladevorgang abgeschlossen ist, auch wenn das Laden nicht erfolgreich war.

Gilt für:

Weitere Informationen