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
}

После завершения musicPropertiesgetMusicPropertiesAsync получает объект MusicProperties.

В этом примере содержит файл StorageFile, представляющий файл, file для которого требуется извлечь свойства.

Комментарии

Доступ к объекту MusicProperties можно получить асинхронно с помощью метода GetMusicPropertiesAsync из свойства Properties элемента (например, файла папки) или синхронно с помощью свойства 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