MusicProperties Classe

Definição

Namespace:

Windows.Storage.FileProperties

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 MusicProperties

Public NotInheritable Class MusicProperties

Herança

Object Platform::Object IInspectable MusicProperties

Atributos

ContractVersionAttribute

Implementações

IStorageItemExtraProperties

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.

Confira também

• GetMusicPropertiesAsync()
• MusicProperties
• MusicProperties
• MusicProperties