Freigeben über

MusicProperties Klasse

  • Referenz

Definition

Namespace:
Windows.Storage.FileProperties
Bearbeiten

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
Object Platform::Object IInspectable MusicProperties
Attribute
ContractVersionAttribute
Implementiert
IStorageItemExtraProperties

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:

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.

Gilt für:

Weitere Informationen