MusicProperties Classe

Definição

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
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:

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.

Aplica-se a

Confira também