Поделиться через


MusicProperties Класс

Определение

Предоставляет доступ к свойствам элемента, связанным с музыкой (например, к файлу или папке).

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
Атрибуты
Реализации

Требования к 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 можно получить с помощью любого из следующих методов и свойств:

Примечание

Свойства, которые получаются или задаются с помощью обработчика свойств, определенного другим приложением (например, 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>>)

Сохраняет указанные свойства и значения, связанные с элементом.

Применяется к

См. также раздел