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