Méthode IWMPMediaCollection::getByName
[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 getByName
méthode retourne une interface IWMPPlaylist qui fournit l’accès aux éléments multimédias portant le nom spécifié.
Syntaxe
public IWMPPlaylist getByName(
System.String bstrName
);
Public Function getByName( _
ByVal bstrName As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByName
Paramètres
-
bstrName [in]
-
System.String qui est le nom spécifié.
Valeur retournée
Interface WMPLib.IWMPPlaylist pour les éléments multimédias récupérés.
Notes
Avant d’appeler cette méthode, vous devez disposer d’un accès en lecture à la bibliothèque. Pour plus d’informations, consultez Accès à la bibliothèque.
Il existe deux façons de récupérer une interface IWMPMediaCollection , et le comportement de la méthode dépend de laquelle getByName
de ces deux méthodes vous utilisez. Si vous récupérez l’interface en appelant AxWindowsMediaPlayer.mediaCollection, la getByName
méthode retourne tous les éléments multimédias de la bibliothèque. Toutefois, si vous récupérez l’interface en appelant IWMPLibrary.mediaCollection, la getByName
méthode retourne uniquement les éléments audio de la bibliothèque qui ont l’attribut et la valeur spécifiés.
Exemples
L’exemple suivant utilise getByName
pour récupérer trois éléments de la bibliothèque. Chaque élément est ensuite ajouté à la playlist active. L’objet AxWMPLib.AxWindowsMediaPlayer est représenté par la variable nommée player.
// In each case, use the name exactly as it appears in the library.
// Windows Media Player does not include file name extensions or file paths
// in the name. Internet URLs include the entire path, but not the
// file name extension.
// Get an interface to a playlist that contains an Internet URL.
WMPLib.IWMPPlaylist one = player.mediaCollection.getByName("https://www.proseware.com/Media/Laure");
// Get an interface to a playlist that contains a file on a network server.
WMPLib.IWMPPlaylist two = player.mediaCollection.getByName("Jeanne");
// Get an interface to a playlist that contains a file on a local drive.
WMPLib.IWMPPlaylist three = player.mediaCollection.getByName("house");
// Append each item to the current playlist. Since each playlist retrieved
// using getByName contains one digital media item, use the get_Item
// method with an index of zero to reference that item.
player.currentPlaylist.appendItem(one.get_Item(0));
player.currentPlaylist.appendItem(two.get_Item(0));
player.currentPlaylist.appendItem(three.get_Item(0));
' In each case, use the name exactly as it appears in the library.
' Windows Media Player does not include file name extensions or file paths
' in the name. Internet URLs include the entire path, but not the
' file name extension.
' Get an interface to a playlist that contains an Internet URL.
Dim one As WMPLib.IWMPPlaylist = player.mediaCollection.getByName("https://www.proseware.com/Media/Laure")
' Get an interface to a playlist that contains a file on a network server.
Dim two As WMPLib.IWMPPlaylist = player.mediaCollection.getByName("Jeanne")
' Get an interface to a playlist that contains a file on a local drive.
Dim three As WMPLib.IWMPPlaylist = player.mediaCollection.getByName("house")
' Append each item to the current playlist. Since each playlist retrieved
' using getByName contains one digital media item, use the Item
' property with an index of zero to reference that item.
player.currentPlaylist.appendItem(one.Item(0))
player.currentPlaylist.appendItem(two.Item(0))
player.currentPlaylist.appendItem(three.Item(0))
Configuration requise
Condition requise | Valeur |
---|---|
Version |
Lecteur multimédia Windows série 9 ou ultérieure |
Espace de noms |
WMPLib |
Assembly |
|
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour