SoundPlayer.Load Methode

Definition

Namespace:

System.Media

Assembly:

System.Windows.Extensions.dll

Paket:

System.Windows.Extensions v8.0.0

Quelle:

SoundPlayer.cs

Lädt einen Sound synchron.

public:
 void Load();

public void Load ();

member this.Load : unit -> unit

Public Sub Load ()

Ausnahmen

TimeoutException

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

FileNotFoundException

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 zum Laden einer WAV-Datei, 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.

Weitere Informationen

• LoadAsync()
• LoadCompleted
• Übersicht über die SoundPlayer-Klasse (Windows Forms)