IWMPMediaCollection::add, méthode

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La méthode add ajoute un nouvel élément multimédia ou une playlist à la bibliothèque.

Syntaxe

public IWMPMedia add(
  System.String bstrURL
);

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

Paramètres

bstrURL [in]

System.String qui est l’URL qui spécifie l’emplacement de l’élément multimédia ou de la playlist.

Valeur retournée

Interface WMPLib.IWMPMedia pour l’élément ou la playlist ajouté.

Notes

Cette méthode charge un élément multimédia ou une playlist existant dans la bibliothèque, en fonction d’un chemin d’accès. Cette méthode ne déplace pas ou ne modifie pas le fichier. Cette méthode échoue si un chemin d’accès local n’est pas valide, mais la validité des éléments multimédias eux-mêmes n’est pas vérifiée avant leur ajout à la bibliothèque.

Cette méthode accepte les fichiers de sélection statique et automatique. La méthode IWMPPlaylistCollection.importPlaylist peut également être utilisée pour ajouter une playlist statique à la bibliothèque.

Avant d’appeler cette méthode, vous devez disposer d’un accès complet à la bibliothèque. Pour plus d’informations, consultez Accès à la bibliothèque.

Exemples

L’exemple suivant ajoute trois objets multimédias à la collection de supports Lecteur multimédia Windows. L’objet AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée player.

// 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")

Configuration requise

Condition requise	Valeur
Version	série Lecteur multimédia Windows 9 ou ultérieure
Espace de noms	WMPLib
Assembly	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Voir aussi

IWMPMediaCollection, interface (VB et C#)

IWMPMediaCollection.remove (VB et C#)

IWMPPlaylistCollection.importPlaylist (VB et C#)