IWMPMediaCollection::add-Methode

[Das dieser Seite zugeordnete Feature Windows Medienwiedergabe SDK ist ein Legacyfeature. Es wurde von MediaPlayer ersetzt. MediaPlayer wurde für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, nach Möglichkeit für neuen Code MediaPlayer anstelle von Windows Medienwiedergabe SDK zu verwenden. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die add-Methode fügt der Bibliothek ein neues Medienelement oder eine neue Wiedergabeliste hinzu.

Syntax

public IWMPMedia add(
  System.String bstrURL
);

Public Function add( _
  ByVal bstrURL As System.String _
) As IWMPMedia
Implements IWMPMediaCollection.add

Parameter

bstrURL [in]

Eine System.String-URL , die den Speicherort des Medienelements oder der Wiedergabeliste angibt.

Rückgabewert

Die WMPLib.IWMPMedia-Schnittstelle für das hinzugefügte Element oder die hinzugefügte Wiedergabeliste.

Bemerkungen

Diese Methode lädt ein vorhandenes Medienelement oder eine Wiedergabeliste unter Angabe eines Pfads in die Bibliothek. Mit dieser Methode wird die Datei nicht verschoben oder geändert. Diese Methode schlägt fehl, wenn ein ungültiger lokaler Pfad angegeben wird, aber Medienelemente selbst werden nicht auf Ihre Gültigkeit überprüft, bevor sie der Bibliothek hinzugefügt werden.

Diese Methode akzeptiert sowohl statische als auch automatische Wiedergabelistendateien. Die IWMPPlaylistCollection.importPlaylist-Methode kann auch verwendet werden, um der Bibliothek eine statische Wiedergabeliste hinzuzufügen.

Bevor Sie diese Methode aufrufen, müssen Sie vollzugriff auf die Bibliothek haben. Weitere Informationen finden Sie unter Bibliothekszugriff.

Beispiele

Im folgenden Beispiel werden der Windows Medienwiedergabe Medienauflistung drei Medienobjekte hinzugefügt. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable player dargestellt.

// Adding a media object using a website.
player.mediaCollection.add("https://www.proseware.com/Media/Laure.wma");

// Adding a media object from a local network.
// Either use the @ symbol to denote a quoted string literal or add additional
// backlashes as an escape for every original backslash.
player.mediaCollection.add(@"\\yourservername\Public\Jeanne.wma");

// Adding a media object from a file on a local drive.
// Either use the @ symbol to denote a quoted string literal or add additional
// backlashes as an escape for every original backslash.
player.mediaCollection.add(@"C:\WMSDK\WMPSDK\samples\media\house.wma");

' Adding a media object using a website.
player.mediaCollection.add("http:'www.proseware.com/Media/Laure.wma")

' Adding a media object from a local network.
player.mediaCollection.add("\\yourservername\Public\Jeanne.wma")

' Adding a media object from a file on a local drive.
player.mediaCollection.add("C:\WMSDK\WMPSDK\samples\media\house.wma")

Anforderungen

Anforderung	Wert
Version	Windows Medienwiedergabe Serie 9 oder höher
Namespace	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Siehe auch

IWMPMediaCollection-Schnittstelle (VB und C#)

IWMPMediaCollection.remove (VB und C#)

IWMPPlaylistCollection.importPlaylist (VB und C#)