MusicProperties Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ermöglicht den Zugriff auf die musikbezogenen Eigenschaften eines Elements (z. B. einer Datei oder eines Ordners).
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
- Vererbung
- Attribute
- Implementiert
Windows-Anforderungen
Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Beispiele
In diesem Beispiel wird veranschaulicht, wie Eigenschaften einer Datei abgerufen werden, einschließlich Musikeigenschaften wie Album und Bewertung.
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
}
Ruft nach Abschluss musicProperties
von GetMusicPropertiesAsync ein MusicProperties-Objekt ab.
Enthält im Beispiel eine StorageFile-Datei, die die Datei darstellt, file
für die Eigenschaften abgerufen werden sollen.
Hinweise
Sie können asynchron auf ein MusicProperties-Objekt zugreifen, indem Sie die GetMusicPropertiesAsync-Methode über die Properties-Eigenschaft eines Elements (z. B. eine Ordnerdatei) oder synchron die MusicProperties-Eigenschaft verwenden, wenn sie verfügbar ist. Sie können ein musicProperties-Objekt mit einer der folgenden Methoden und Eigenschaften abrufen:
- StorageItemContentProperties.GetMusicPropertiesAsync-Methode , auf die mithilfe der Properties-Eigenschaft zugegriffen werden kann, sofern sie verfügbar ist.
- FileInformation.MusicProperties-Eigenschaft
- FolderInformation.MusicProperties-Eigenschaft
Hinweis
Auf Eigenschaften, die mithilfe eines Eigenschaftenhandlers abgerufen oder festgelegt werden, der von einer anderen App (z. B. Microsoft Word) definiert wird, kann möglicherweise nicht zugegriffen werden. Stattdessen können Sie versuchen, diese Eigenschaften mithilfe einer Dateiabfrage abzurufen, die vom Systemindex unterstützt wird. Weitere Informationen finden Sie unter QueryOptions.
Weitere Codebeispiele zum Zugreifen auf Eigenschaften finden Sie im Dateizugriffsbeispiel.
Eigenschaften
Album |
Ruft den Namen des Albums ab, das den Song enthält, oder legt diesen fest. |
AlbumArtist |
Ruft den Namen des Albumkünstlers des Songs ab oder legt diese fest. |
Artist |
Ruft die Künstler ab, die zum Song beigetragen haben. |
Bitrate |
Ruft die Bitrate der Songdatei ab. |
Composers |
Ruft die Komponisten des Songs ab. |
Conductors |
Ruft die Dirigenten des Songs ab. |
Duration |
Ruft die Dauer des Songs in Millisekunden ab. |
Genre |
Ruft die Namen der Musikgenres ab, zu denen der Song gehört. |
Producers |
Ruft die Produzenten des Songs ab. |
Publisher |
Ruft den Herausgeber des Songs ab oder legt diese fest. |
Rating |
Ruft die Bewertung ab, die einer Musikdatei zugeordnet ist, oder legt sie fest. |
Subtitle |
Ruft den Untertitel des Songs ab oder legt diese fest. |
Title |
Ruft den Titel des Songs ab oder legt den Titel fest. |
TrackNumber |
Ruft die Titelnummer des Songs auf dem Album des Songs ab oder legt diese fest. |
Writers |
Ruft die Songwriter ab. |
Year |
Ruft das Jahr ab, in dem der Song veröffentlicht wurde, oder legt es fest. |
Methoden
RetrievePropertiesAsync(IIterable<String>) |
Ruft die angegebenen musikbezogenen Windows-Dateieigenschaften ab, die dem Element zugeordnet sind. |
SavePropertiesAsync() |
Speichert alle dem Element zugeordneten Eigenschaften. |
SavePropertiesAsync(IIterable<KeyValuePair<String,Object>>) |
Speichert die angegebenen Eigenschaften und Werte, die dem Element zugeordnet sind. |