Metodo IWMPMediaCollection::getByAuthor

[La funzionalità associata a questa pagina, Lettore multimediale Windows SDK, è una funzionalità legacy. È stata sostituita da MediaPlayer. MediaPlayer è stato ottimizzato per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer anziché 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 getByAuthor metodo restituisce un'interfaccia IWMPPlaylist che fornisce l'accesso agli elementi multimediali dell'autore specificato.

Sintassi

public IWMPPlaylist getByAuthor(
  System.String bstrAuthor
);

Public Function getByAuthor( _
  ByVal bstrAuthor As System.String _
) As IWMPPlaylist
Implements IWMPMediaCollection.getByAuthor

Parametri

bstrAuthor [in]

System.String che è il nome dell'autore.

Valore restituito

Interfaccia WMPLib.IWMPPlaylist per gli elementi multimediali recuperati.

Commenti

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

Esistono due modi in cui è possibile recuperare un'interfaccia IWMPMediaCollection e il comportamento del getByAuthor metodo dipende da quale di questi due modi si usa. Se si recupera l'interfaccia chiamando AxWindowsMediaPlayer.mediaCollection, il getByAuthor metodo restituisce tutti gli elementi multimediali della libreria. Tuttavia, se si recupera l'interfaccia chiamando IWMPLibrary.mediaCollection, il getByAuthor metodo restituisce solo gli elementi audio della libreria con l'attributo e il valore specificati.

Esempio

L'esempio seguente usa getByAuthor per creare una playlist di elementi multimediali quando l'utente fa clic su un pulsante. La playlist contiene elementi corrispondenti al nome dell'autore specificato dall'utente in una casella di testo. L'oggetto AxWMPLib.AxWindowsMediaPlayer è rappresentato dalla variabile denominata player.

private void playAuthor_Click(object sender, System.EventArgs e)
{ 
    // ...Add code to ensure that the text box contains a valid value.
 
    // Retrieve the author's name from the text box. 
    string author = getAuthor.Text;

    // Create the playlist using getByAuthor. 
    WMPLib.IWMPPlaylist pl = player.mediaCollection.getByAuthor(author);

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

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

Public Sub playAuthor_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles playAuthor.Click

    ' ...Add code to ensure that the text box contains a valid value.

    ' Retrieve the author's name from the text box. 
    Dim author As String = getAuthor.Text

    ' Create the playlist using getByAuthor. 
    Dim pl As WMPLib.IWMPPlaylist = player.mediaCollection.getByAuthor(author)

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

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

End Sub

Requisiti

Requisito	Valore
Versione	Lettore multimediale Windows serie 9 o versioni 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#)