IWMPNetwork::d ownloadProgress-Eigenschaft
Die downloadProgress-Eigenschaft ruft den Prozentsatz des abgeschlossenen Downloads ab.
Syntax
public System.Int32 downloadProgress {get; set;}
Public ReadOnly Property downloadProgress As System.Int32
Eigenschaftswert
Eine System.Int32-Datei, bei der es sich um den Downloadfortschritt in Prozent handelt.
Bemerkungen
Wenn das Windows Media Player-Steuerelement mit einer digitalen Mediendatei verbunden ist, die gleichzeitig wiedergegeben und heruntergeladen werden kann, ruft die downloadProgress-Eigenschaft den Prozentsatz der heruntergeladenen Gesamtdatei ab. Dieses Feature wird derzeit nur für digitale Mediendateien unterstützt, die von Webservern heruntergeladen wurden. Eine Datei eines der folgenden Formate kann heruntergeladen und gleichzeitig wiedergegeben werden:
- Advanced Systems Format (ASF)
- Windows Media Audio (WMA)
- Windows Media Video (WMV)
- MP3
- MPEG
- WAV
Darüber hinaus können einige AVI-Dateien heruntergeladen und gleichzeitig wiedergegeben werden.
Verwenden Sie AxWindowsMediaPlayer. _ WMPOCXEvents _ BufferingEvent, um zu bestimmen, wann die Pufferung gestartet oder beendet wird.
Beispiele
Im folgenden Codebeispiel wird downloadProgress verwendet, um den Prozentsatz des abgeschlossenen Downloads anzuzeigen. Die Informationen werden als Reaktion auf das Pufferereignis in einer Bezeichnung angezeigt. Im Beispiel wird ein Timer mit einem Intervall von 1 Sekunde verwendet, um die Anzeige zu aktualisieren. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable player dargestellt.
// Add a delegate for the Buffering event.
player.Buffering += new AxWMPLib._WMPOCXEvents_BufferingEventHandler(player_Buffering);
// Create an event handler for the Buffering event.
private void player_Buffering(object sender, AxWMPLib._WMPOCXEvents_BufferingEvent e)
{
// Determine whether buffering has started or stopped.
if (e.start == true)
{
// Set the timer interval at one second (1000 miliseconds).
timer.Interval = 1000;
// Start the timer.
timer.Start();
}
else
{
// Buffering is complete. Stop the timer.
timer.Stop();
}
}
// Update the download progress in a timer event handler.
private void UpdateDownloadProgress(object sender, EventArgs e)
{
downloadProgressLabel.Text = ("Download progress: " + player.network.downloadProgress + " percent complete");
}
' Create an event handler for the Buffering event.
Public Sub player_Buffering(ByVal sender As Object, ByVal e As AxWMPLib._WMPOCXEvents_BufferingEvent) Handles player.Buffering
' Test whether packets may be arriving.
Select Case e.newState
' If WMPPlayState is Stopped, Paused, ScanForward, ScanReverse, Waiting, MediaEnded
' or Transitioning then stop the timer.
Case 1
Case 2
Case 4
Case 5
Case 7
Case 8
Case 9
timer.Stop()
' If WMPPlayState is Playing or Buffering then set the timer interval and start the timer.
Case Else
timer.Interval = 1000
timer.Start()
End Select
End Sub
' Update the download progress in a timer event handler.
Public Sub UpdateDownloadProgress(ByVal sender As Object, ByVal e As System.EventArgs) Handles timer.Tick
downloadProgressLabel.Text = ("Download progress: " + player.network.downloadProgress + " percent complete")
End Sub
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Version |
Windows Media Player 9er Serie oder höher |
| Namespace |
WMPLib |
| Assembly |
|