IWMPMediaCollection：：getAttributeStringCollection 方法

[与此页面关联的功能（Windows 媒体播放器 SDK）是旧版功能。 它已被 MediaPlayer 取代。 MediaPlayer 已针对Windows 10和Windows 11进行了优化。 Microsoft 强烈建议新代码尽可能使用 MediaPlayer 而不是 Windows 媒体播放器 SDK。 如果可能，Microsoft 建议重写使用旧 API 的现有代码以使用新 API。]

getAttributeStringCollection 方法返回一个 IWMPStringCollection 接口，该接口表示媒体类型中指定属性的所有值集。

语法

public IWMPStringCollection getAttributeStringCollection(
  System.String bstrAttribute,
  System.String bstrMediaType
);

Public Function getAttributeStringCollection( _
  ByVal bstrAttribute As System.String, _
  ByVal bstrMediaType As System.String _
) As IWMPStringCollection
Implements IWMPMediaCollection.getAttributeStringCollection

参数

bstrAttribute [in]

一个 System.String ，它是检索其值的属性。

bstrMediaType [in]

一个 System.String ，它是为其检索值的媒体类型。

返回值

检索到的值的 WMPLib.IWMPStringCollection 接口。

备注

在调用此方法之前，必须具有对库的读取访问权限。 有关详细信息，请参阅 库访问。

有关Windows 媒体播放器支持的属性的信息，请参阅属性参考。

示例

以下示例使用 getAttributeStringCollection 显示与媒体集合中音频项的特定属性对应的值列表。 列表框允许用户选择一个属性，例如“艺术家”、“流派”或“专辑”，多行文本框显示结果。 AxWMPLib.AxWindowsMediaPlayer 对象由名为 player 的变量表示。

private void audioAttributes_OnSelectedIndexChanged(object sender, System.EventArgs e)
{
    // Retrieve the attribute type from the ListBox
    string attributeType = (string)((System.Windows.Forms.ListBox)sender).SelectedItem;

    // Get an interface to the mediaCollection.  
    WMPLib.IWMPMediaCollection2 library = (WMPLib.IWMPMediaCollection2)player.mediaCollection;

    // Get an interface to the string collection for the attribute type the user selects.
    WMPLib.IWMPStringCollection2 all = (WMPLib.IWMPStringCollection2)library.getAttributeStringCollection(attributeType, "Audio");

    // Clear the text box of previous results.
    attributeValues.Clear();

    // Create an array to hold the attribute values.
    string[] attributeArray = new string[all.count];
    
    // Loop through the string collection.
    for (int i = 0; i < all.count; i++)
    {
        // Store the items in the array.
        attributeArray[i] = all.Item(i);
    }

    // Display the items in the text box.
    attributeValues.Lines = attributeArray;
}

Public Sub audioAttributes_OnSelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs) Handles audioAttributes.SelectedIndexChanged

    ' Retrieve the attribute type from the ListBox
    Dim lb As System.Windows.Forms.ListBox = sender
    Dim attributeType As String = lb.SelectedItem

    ' Get an interface to the mediaCollection.  
    Dim library As WMPLib.IWMPMediaCollection2 = player.mediaCollection

    ' Get an interface to the string collection for the attribute type the user selects.
    Dim all As WMPLib.IWMPStringCollection2 = library.getAttributeStringCollection(attributeType, "Audio")

    ' Clear the text box of previous results.
    attributeValues.Clear()

    ' Create an array to hold the attribute values.
    Dim attributeArray(all.count) As String

    ' Loop through the string collection.
    For i As Integer = 0 To (all.count - 1)

        ' Store the items in the array.
        attributeArray(i) = all.Item(i)

    Next i

    ' Display the items in the text box.
    attributeValues.Lines = attributeArray

End Sub

要求

要求	值
版本	Windows 媒体播放器 9 系列或更高版本
命名空间	WMPLib
程序集	Interop.WMPLib.dll (Interop.WMPLib.dll.dll)

另请参阅

IWMPMediaCollection 接口 (VB 和 C#)

IWMPStringCollection 接口 (VB 和 C#)