MusicProperties 类

定义

命名空间:

Windows.Storage.FileProperties

提供对项的音乐相关属性的访问， (如文件或文件夹) 。

public ref class MusicProperties sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class MusicProperties final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class MusicProperties

Public NotInheritable Class MusicProperties

继承

Object Platform::Object IInspectable MusicProperties

属性

ContractVersionAttribute

实现

IStorageItemExtraProperties

Windows 要求

设备系列	Windows 10 (在 10.0.10240.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v1.0 中引入)

示例

此示例演示如何检索文件的属性，包括音乐属性，如 Album 和 Rating。

try
{
    StorageFile file = rootPage.sampleFile;
    if (file != null)
    {
        StringBuilder outputText = new StringBuilder();

        // Get music properties
        MusicProperties musicProperties = await file.Properties.GetMusicPropertiesAsync();
        outputText.AppendLine("Album: " + musicProperties.Album);
        outputText.AppendLine("Rating: " + musicProperties.Rating);
    }
}
// Handle errors with catch blocks
catch (FileNotFoundException)
{
 // For example, handle a file not found error
}

GetMusicPropertiesAsync 完成后，musicProperties获取 MusicProperties 对象。

在示例中， file 包含一个 StorageFile ，表示要为其检索属性的文件。

注解

可以使用 GetMusicPropertiesAsync 方法从项 (的 Properties 属性（如文件夹) 的文件）使用 GetMusicPropertiesAsync 方法异步访问 MusicProperties 对象，也可以使用 MusicProperties 属性进行同步访问（如果可用）。 可以使用以下任一方法和属性获取 musicProperties 对象：

• StorageItemContentProperties.GetMusicPropertiesAsync 方法，可以使用 Properties 属性（如果可用）访问该方法。
• FileInformation.MusicProperties 属性
• FolderInformation.MusicProperties 属性

注意

使用由其他应用（如 Microsoft Word) ）定义的属性处理程序获取或设置的属性 (可能无法访问。 相反，可以尝试使用由系统索引支持的文件查询来获取这些属性。 有关详细信息，请参阅 QueryOptions。

有关访问属性的更多代码示例，请参阅 文件访问示例。

属性

Album	获取或设置包含歌曲的专辑的名称。
AlbumArtist	获取或设置歌曲的专辑艺术家的姓名。
Artist	获取为歌曲做出贡献的艺术家。
Bitrate	获取歌曲文件的比特率。
Composers	获取歌曲的作曲家。
Conductors	获取歌曲的指挥。
Duration	获取歌曲的持续时间（以毫秒为单位）。
Genre	获取歌曲所属的音乐流派的名称。
Producers	获取歌曲的制作者。
Publisher	获取或设置歌曲的发布者。
Rating	获取或设置与音乐文件关联的分级。
Subtitle	获取或设置歌曲的副标题。
Title	获取或设置歌曲的标题
TrackNumber	获取或设置歌曲专辑中歌曲的曲目编号。
Writers	获取词曲作者。
Year	获取或设置歌曲的发行年份。

方法

RetrievePropertiesAsync(IIterable<String>)	检索与该项关联的指定音乐相关 Windows 文件属性。
SavePropertiesAsync()	保存与项关联的所有属性。
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>)	保存与项关联的指定属性和值。

另请参阅

• GetMusicPropertiesAsync()
• MusicProperties
• MusicProperties
• MusicProperties