MusicProperties Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece acesso às propriedades relacionadas à música de um item (como um arquivo ou pasta).
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- Herança
- Atributos
- Implementações
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Exemplos
Este exemplo demonstra como recuperar propriedades de um arquivo, incluindo propriedades musicais como Album e 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
}
Após a conclusão de GetMusicPropertiesAsync , musicProperties obtém um objeto MusicProperties.
No exemplo, file contém um StorageFile que representa o arquivo para o qual recuperar propriedades.
Comentários
Você pode acessar um objeto MusicProperties de forma assíncrona usando o método GetMusicPropertiesAsync da propriedade Properties de um item (como um arquivo de pasta) ou de forma síncrona usando a propriedade MusicProperties se estiver disponível. Você pode obter um objeto musicProperties usando qualquer um dos seguintes métodos e propriedades:
- Método StorageItemContentProperties.GetMusicPropertiesAsync , que pode ser acessado usando a propriedade Properties , se estiver disponível.
- Propriedade FileInformation.MusicProperties
- Propriedade FolderInformation.MusicProperties
Observação
As propriedades que são obter ou definir usando um manipulador de propriedades definido por outro aplicativo (como o Microsoft Word) podem não estar acessíveis. Em vez disso, você pode tentar obter essas propriedades usando uma consulta de arquivo que é apoiada pelo índice do sistema. Para obter mais informações, consulte QueryOptions.
Para obter mais exemplos de código sobre como acessar propriedades, consulte o Exemplo de acesso a arquivos.
Propriedades
| Album |
Obtém ou define o nome do álbum que contém a música. |
| AlbumArtist |
Obtém ou define o nome do artista do álbum da canção. |
| Artist |
Obtém os artistas que contribuíram para a música. |
| Bitrate |
Obtém a taxa de bits do arquivo de música. |
| Composers |
Obtém os compositores da canção. |
| Conductors |
Obtém os maestros da canção. |
| Duration |
Obtém a duração da música em milissegundos. |
| Genre |
Obtém os nomes dos gêneros musicais aos quais a música pertence. |
| Producers |
Obtém os produtores da música. |
| Publisher |
Obtém ou define o editor da música. |
| Rating |
Obtém ou define a classificação associada a um arquivo de música. |
| Subtitle |
Obtém ou define o subtítulo da música. |
| Title |
Obtém ou define o título da música |
| TrackNumber |
Obtém ou define o número da faixa da música no álbum da canção. |
| Writers |
Obtém os compositores. |
| Year |
Obtém ou define o ano em que a música foi lançada. |
Métodos
| RetrievePropertiesAsync(IIterable<String>) |
Recupera as propriedades de arquivo do Windows relacionadas à música especificadas associadas ao item. |
| SavePropertiesAsync() |
Salva todas as propriedades associadas ao item. |
| SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Salva as propriedades e os valores especificados associados ao item. |