IWMPPlaylistCollection::newPlaylist-Methode

Artikel
06/21/2023

[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 newPlaylist-Methode gibt eine IWMPPlaylist-Schnittstelle für eine neue, leere Wiedergabeliste in der Bibliothek zurück.

Syntax

public IWMPPlaylist newPlaylist(
  System.String bstrName
);


Public Function newPlaylist( _
  ByVal bstrName As System.String _
) As IWMPPlaylist
Implements IWMPPlaylistCollection.newPlaylist

Parameter

bstrName [in]: Ein System.String , der der Name der neuen Wiedergabeliste ist.

Rückgabewert

Eine WMPLib.IWMPPlaylist-Schnittstelle für die neue Wiedergabeliste.

Bemerkungen

Diese Methode erstellt eine leere Wiedergabeliste in der Bibliothek. Um die Wiedergabeliste mit Medienelementen zu füllen, verwenden Sie IWMPPlaylist.appendItem oder IWMPPlaylist.insertItem.

Mehrere Wiedergabelisten mit demselben Namen sind in der Bibliothek zulässig. Um das Erstellen eines doppelten Wiedergabelistennamens mit dieser Methode zu vermeiden, verwenden Sie die getByName-Methode und IWMPPlaylistArray.count , um zu ermitteln, ob eine Wiedergabeliste mit einem bestimmten Namen bereits vorhanden ist.

Führende und nachfolgende Leerzeichen sind in Wiedergabelistennamen nicht zulässig und werden automatisch aus dem für den bstrName-Parameter angegebenen Wert entfernt.

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

Beispiele

Im folgenden Beispiel wird eine neue leere Wiedergabeliste namens "ThreeList" erstellt, der Wiedergabelistensammlung hinzugefügt und eine Schnittstelle zurückgegeben. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable player dargestellt.

// Add a new empty playlist, named ThreeList, to the playlist collection.
WMPLib.IWMPPlaylist newList = player.playlistCollection.newPlaylist("ThreeList");


'  Add a new empty playlist, named ThreeList, to the playlist collection.
Dim newList As WMPLib.IWMPPlaylist = player.playlistCollection.newPlaylist(&quot;ThreeList&quot;)

Anforderungen

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

Siehe auch

IWMPPlaylist-Schnittstelle (VB und C#)
IWMPPlaylist.appendItem (VB und C#)
IWMPPlaylist.insertItem (VB und C#)
IWMPPlaylistArray.count (VB und C#)
IWMPPlaylistCollection-Schnittstelle (VB und C#)
IWMPPlaylistCollection.getByName (VB und C#)