MusicProperties Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona acceso a las propiedades relacionadas con la música de un elemento (como un archivo o carpeta).
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- Herencia
- Atributos
- Implementaciones
Requisitos de Windows
| Familia de dispositivos |
Windows 10 (se introdujo en la versión 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
|
Ejemplos
En este ejemplo se muestra cómo recuperar propiedades de un archivo, incluidas las propiedades de música como Album y 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
}
Una vez completado GetMusicPropertiesAsync , musicProperties obtiene un objeto MusicProperties.
En el ejemplo, file contiene un storageFile que representa el archivo para el que se van a recuperar las propiedades.
Comentarios
Puede acceder a un objeto MusicProperties de forma asincrónica mediante el método GetMusicPropertiesAsync desde la propiedad Properties de un elemento (como un archivo de carpeta) o mediante la propiedad MusicProperties de forma sincrónica si está disponible. Puede obtener un objeto musicProperties mediante cualquiera de los métodos y propiedades siguientes:
- Método StorageItemContentProperties.GetMusicPropertiesAsync , al que se puede acceder mediante la propiedad Properties , si está disponible.
- Propiedad FileInformation.MusicProperties
- Propiedad FolderInformation.MusicProperties
Nota:
Es posible que no se pueda acceder a las propiedades que se obtienen o establecen mediante un controlador de propiedades definido por otra aplicación (como Microsoft Word). En su lugar, puede intentar obtener estas propiedades mediante una consulta de archivo respaldada por el índice del sistema. Para obtener más información, consulte QueryOptions.
Para obtener más ejemplos de código sobre el acceso a las propiedades, consulte el ejemplo de acceso a archivos.
Propiedades
| Album |
Obtiene o establece el nombre del álbum que contiene la canción. |
| AlbumArtist |
Obtiene o establece el nombre del artista del álbum de la canción. |
| Artist |
Obtiene a los artistas que han contribuido a la canción. |
| Bitrate |
Obtiene la velocidad de bits del archivo de canciones. |
| Composers |
Obtiene los compositores de la canción. |
| Conductors |
Obtiene los conductores de la canción. |
| Duration |
Obtiene la duración de la canción en milisegundos. |
| Genre |
Obtiene los nombres de los géneros musicales a los que pertenece la canción. |
| Producers |
Obtiene los productores de la canción. |
| Publisher |
Obtiene o establece el publicador de la canción. |
| Rating |
Obtiene o establece la clasificación asociada a un archivo de música. |
| Subtitle |
Obtiene o establece el subtítulo de la canción. |
| Title |
Obtiene o establece el título de la canción. |
| TrackNumber |
Obtiene o establece el número de pista de la canción en el álbum de la canción. |
| Writers |
Obtiene a los compositores. |
| Year |
Obtiene o establece el año en que se lanzó la canción. |
Métodos
| RetrievePropertiesAsync(IIterable<String>) |
Recupera las propiedades de archivo de Windows relacionadas con la música especificadas asociadas al elemento. |
| SavePropertiesAsync() |
Guarda todas las propiedades asociadas al elemento. |
| SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Guarda las propiedades y valores especificados asociados al elemento. |