Metodo IWMPMediaCollection::getByAttribute

  • Articolo

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stato sostituito da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer invece di Lettore multimediale Windows SDK, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il metodo getByAttribute restituisce un'interfaccia IWMPPlaylist che corrisponde all'attributo specificato con il valore specificato.

Sintassi

public IWMPPlaylist getByAttribute(
  System.String bstrAttribute,
  System.String bstrValue
);


Public Function getByAttribute( _
  ByVal bstrAttribute As System.String, _
  ByVal bstrValue As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByAttribute

Parametri

bstrAttribute [in]

Oggetto System.String che rappresenta l'attributo specificato.

bstrValue [in]

System.String che rappresenta il valore specificato.

Valore restituito

Interfaccia WMPLib.IWMPPlaylist per gli elementi multimediali recuperati.

Commenti

Questo metodo può essere usato per creare una query generica per gli elementi multimediali che corrispondono a un valore per un attributo nella libreria. Ciò è utile nel caso di attributi definiti dall'utente. Se l'attributo non esiste, verrà restituito un errore.

È possibile utilizzare questo metodo per recuperare tutti gli elementi multimediali di un tipo specifico. Usare il nome dell'attributo MediaType e uno dei valori seguenti.

Valore Descrizione
Audio Musica e altri elementi solo audio
altro Altri elementi, ad esempio un file con estensione asf o l'URL di un flusso.
Foto Elementi fotografici. Richiede Lettore multimediale Windows 10.
Playlist Playlist rappresentate come elementi multimediali.
radio Elementi della stazione radio. Non utilizzato da Lettore multimediale Windows 10.
Video Elementi video.

Prima di chiamare questo metodo, è necessario disporre dell'accesso in lettura alla libreria. Per altre informazioni, vedere Accesso alla libreria.

Per informazioni sugli attributi supportati da Lettore multimediale Windows, vedere Riferimento agli attributi.

Esistono due modi per recuperare un'interfaccia IWMPMediaCollection e il comportamento del metodo getByAttribute dipende da quali di questi due modi usi. Se si recupera l'interfaccia chiamando AxWindowsMediaPlayer.mediaCollection, il metodo getByAttribute restituisce tutti gli elementi multimediali nella libreria. Tuttavia, se si recupera l'interfaccia chiamando IWMPLibrary.mediaCollection, il metodo getByAttribute restituisce solo gli elementi audio nella libreria con l'attributo e il valore specificati.

Esempio

L'esempio di codice seguente usa getByAttribute per riprodurre tutto il contenuto della libreria dall'artista denominato Triode 48. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

// Get an interface to a playlist that contains media items by a particular artist.
WMPLib.IWMPPlaylist pl = player.mediaCollection.getByAttribute("Artist", "Triode 48");

// Make the new playlist the current one.
player.currentPlaylist = pl;

// Play the media items in the current playlist. 
player.Ctlcontrols.play();


' Get an interface to a playlist that contains media items by a particular artist.
Dim pl As WMPLib.IWMPPlaylist = player.mediaCollection.getByAttribute("Artist", "Triode 48")

' Make the new playlist the current one.
player.currentPlaylist = pl

' Play the media items in the current playlist. 
player.Ctlcontrols.play()

Requisiti

Requisito Valore
Versione
 Lettore multimediale Windows serie 9 o successive
Spazio dei nomi
 WMPLib
Assembly
Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

Vedi anche

Interfaccia IWMPMediaCollection (VB e C#)

Interfaccia IWMPPlaylist (VB e C#)

IWMPPlaylistCollection.getAll (VB e C#)