IWMPMediaCollection::getByAuthor-Methode

Die getByAuthor -Methode gibt eine IWMPPlaylist-Schnittstelle zurück, die den Zugriff auf die Medienelemente durch den angegebenen Autor ermöglicht.

Syntax

public IWMPPlaylist getByAuthor(
  System.String bstrAuthor
);

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

Parameter

bstrAuthor [ In]

Die System.String, die der Name des Autors ist.

Rückgabewert

Eine WMPLib.IWMPPlaylist-Schnittstelle für die abgerufenen Medienelemente.

Bemerkungen

Bevor Sie diese Methode aufrufen, müssen Sie über Lesezugriff auf die Bibliothek verfügen. Weitere Informationen finden Sie unter Bibliothekszugriff.

Es gibt zwei Möglichkeiten, wie Sie eine IWMPMediaCollection-Schnittstelle abrufen können, und das Verhalten der Methode hängt davon ab, getByAuthor welche dieser beiden Methoden Sie verwenden. Wenn Sie die Schnittstelle durch Aufrufen von AxWindowsMediaPlayer.mediaCollectionabrufen, gibt die Methode alle Medienelemente getByAuthor in der Bibliothek zurück. Wenn Sie die Schnittstelle jedoch durch Aufrufen von IWMPLibrary.mediaCollectionabrufen, gibt die Methode nur die Audioelemente in der Bibliothek zurück, die über das angegebene Attribut und getByAuthor den angegebenen Wert verfügen.

Beispiele

Im folgenden Beispiel wird getByAuthor verwendet, um eine Wiedergabeliste von Medienelementen zu erstellen, wenn der Benutzer auf eine Schaltfläche klickt. Die Wiedergabeliste enthält Elemente, die mit dem vom Benutzer angegebenen Namen des Autors in einem Textfeld übereinstimmen. Das AxWMPLib.AxWindowsMediaPlayer-Objekt wird durch die Variable player dargestellt.

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

Requirements (Anforderungen)

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

Weitere Informationen

IWMPMediaCollection-Schnittstelle (VB und C#)

IWMPPlaylist-Schnittstelle (VB und C#)