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 引進)

範例

此範例示範如何擷取檔案的屬性，包括 相簿 和 分級等音樂屬性。

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 屬性以非同步方式存取 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