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 |
|