ID3V2Tag

ID3V2Tag class

Repräsentiert ein ID3v2-Tag. Weitere Informationen finden Sie unterhttps://en.wikipedia.org/wiki/ID3#ID3v2 .

public sealed class ID3V2Tag : ID3Tag

Konstrukteure

Name Beschreibung
ID3V2Tag() Initialisiert eine neue Instanz vonID3V2Tag Klasse.

Eigenschaften

Name Beschreibung
Album { get; set; } Ruft den Titel des Albums/Films/der Sendung ab oder legt ihn fest. Dieser Wert wird durch den TALB-Rahmen dargestellt.
Artist { get; set; } Ermittelt oder legt den/die Lead Artist(s)/Lead Performer/Solist(s)/Performing Group fest. Dieser Wert wird durch den TPE1-Rahmen dargestellt.
AttachedPictures { get; set; } Ruft die angehängten Bilder ab oder legt sie fest, die sich direkt auf die Audiodatei beziehen. Dieser Wert wird durch den APIC-Rahmen dargestellt.
Band { get; set; } Ruft Band/Orchester/Begleitung ab oder stellt sie ein. Dieser Wert wird durch den TPE2-Rahmen repräsentiert.
BitsPerMinute { get; set; } Ruft die Anzahl der Beats pro Minute im Hauptteil des Audios ab oder legt sie fest. Dieser Wert wird durch den TBPM-Frame dargestellt.
Comments { get; set; } Ruft die Benutzerkommentare ab oder setzt sie. Dieser Wert wird durch den COMM-Rahmen dargestellt. Der Rahmen ist für jede Art von Volltextinformationen gedacht, die in keinen anderen Rahmen passen.
Composers { get; set; } Holt oder setzt die Composer. Die Namen werden mit dem Zeichen „/“ getrennt. Dieser Wert wird durch den TCOM-Frame dargestellt.
ContentType { get; set; } Ruft den Inhaltstyp ab oder legt ihn fest. Dieser Wert wird durch den TCON-Rahmen dargestellt.
Copyright { get; set; } Ruft die Urheberrechtsmeldung ab oder legt sie fest. Dieser Wert wird durch den TCOP-Rahmen dargestellt.
Count { get; } Ruft die Anzahl der Metadateneigenschaften ab.
Date { get; set; } Liest oder setzt eine numerische Zeichenfolge im DDMM-Format, die das Datum für die Aufzeichnung enthält. Dieses Feld ist immer vier Zeichen lang. Dieser Wert wird durch den TDAT-Rahmen dargestellt.
EncodedBy { get; set; } Ruft den Namen der Person oder Organisation ab, die die Audiodatei codiert hat, oder legt diesen fest. Dieser Wert wird durch den TENC-Rahmen dargestellt.
Isrc { get; set; } Ruft den International Standard Recording Code (ISRC) (12 Zeichen) ab oder legt ihn fest. Dieser Wert wird durch den TSRC-Rahmen dargestellt.
Item { get; } Ruft die abMetadataProperty mit dem angegebenen Namen.
Keys { get; } Ruft eine Sammlung der Metadaten-Eigenschaftsnamen ab.
LengthInMilliseconds { get; set; } Ruft die Länge der Audiodatei in Millisekunden ab oder legt sie fest, dargestellt als numerische Zeichenfolge. Dieser Wert wird durch den TLEN-Frame dargestellt.
MetadataType { get; } Ruft den Metadatentyp ab.
MusicalKey { get; set; } Ruft die Tonart ab, in der der Ton beginnt, oder legt sie fest. Dieser Wert wird durch den TKEY-Rahmen dargestellt.
OriginalAlbum { get; set; } Ruft den Originaltitel des Albums/Films/der Sendung ab oder legt ihn fest. Dieser Wert wird durch den TOAL-Frame dargestellt.
PropertyDescriptors { get; } Ruft eine Sammlung von Deskriptoren ab, die Informationen zu Eigenschaften enthalten, auf die über die Suchmaschine GroupDocs.Metadata zugegriffen werden kann.
Publisher { get; set; } Ruft den Namen des Labels oder Herausgebers ab oder legt ihn fest. Dieser Wert wird durch den TPUB-Rahmen dargestellt.
SizeInBytes { get; set; } Ruft die Größe der Audiodatei in Bytes ab oder legt sie fest, ohne das ID3v2-Tag, dargestellt als numerische Zeichenfolge. Dieser Wert wird durch den TSIZ-Frame dargestellt.
SoftwareHardware { get; set; } Ermittelt oder setzt den verwendeten Audio-Encoder und seine Einstellungen beim Encodieren der Datei. Dieser Wert wird durch den TSSE-Frame dargestellt.
Subtitle { get; set; } Ruft die Subtitle/Description-Verfeinerung ab oder legt sie fest. Dieser Wert wird durch den TIT3-Frame repräsentiert.
TagSize { get; } Ruft die Größe des Tags ab.
Time { get; set; } Liest oder setzt eine numerische Zeichenfolge im HHMM-Format, die die Zeit für die Aufzeichnung enthält. Dieses Feld ist immer vier Zeichen lang. Dieser Wert wird durch den Rahmen TIME dargestellt.
Title { get; set; } Ruft Titel/Songname/Inhaltsbeschreibung ab oder legt sie fest. Dieser Wert wird durch den TIT2-Rahmen repräsentiert.
TrackNumber { get; set; } Erhält oder setzt eine numerische Zeichenkette, die die Ordnungsnummer der Audiodatei auf ihrer Originalaufnahme enthält. Dieser Wert wird durch den TRCK-Rahmen dargestellt.
TrackPlayCounter { get; } Ruft ab, wie oft die Datei abgespielt wurde. Dieser Wert wird durch den PCNT-Rahmen dargestellt.
override Version { get; } Ruft die ID3-Version ab.
Year { get; set; } Liest oder setzt eine numerische Zeichenkette mit einem Jahr der Aufnahme. Dieser Rahmen ist immer vier Zeichen lang (bis zum Jahr 10000). Dieser Wert wird durch den TYER-Rahmen dargestellt.

Methoden

Name Beschreibung
Add(ID3V2TagFrame) Fügt dem Tag einen Rahmen hinzu.
AddProperties(Func<MetadataProperty, bool>, PropertyValue) Fügt bekannte Metadateneigenschaften hinzu, die das angegebene Prädikat erfüllen. Die Operation ist rekursiv, sodass sie sich auch auf alle verschachtelten Pakete auswirkt.
Clear(string) Entfernt alle Frames mit der angegebenen ID.
Contains(string) Bestimmt, ob das Paket eine Metadateneigenschaft mit dem angegebenen Namen enthält.
virtual FindProperties(Func<MetadataProperty, bool>) Findet die Metadateneigenschaften, die das angegebene Prädikat erfüllen. Die Suche ist rekursiv, sodass sie auch alle verschachtelten Pakete betrifft.
Get(string) Ruft ein Array von Frames mit der angegebenen ID ab.
GetEnumerator() Gibt einen Enumerator zurück, der die Sammlung durchläuft.
Remove(ID3V2TagFrame) Entfernt den angegebenen Frame aus dem Tag.
RemoveAttachedPictures() Entfernt alle angehängten Bilder, die in APIC-Frames gespeichert sind.
virtual RemoveProperties(Func<MetadataProperty, bool>) Entfernt Metadateneigenschaften, die das angegebene Prädikat erfüllen.
virtual Sanitize() Entfernt beschreibbare Metadateneigenschaften aus dem Paket. Der Vorgang ist rekursiv, sodass er sich auch auf alle verschachtelten Pakete auswirkt.
Set(ID3V2TagFrame) Entfernt alle Frames mit derselben ID wie der angegebene und fügt den neuen Frame zum Tag hinzu.
SetProperties(Func<MetadataProperty, bool>, PropertyValue) Legt bekannte Metadateneigenschaften fest, die das angegebene Prädikat erfüllen. Die Operation ist rekursiv, sodass sie sich auch auf alle verschachtelten Pakete auswirkt. Diese Methode ist eine Kombination ausAddProperties UndUpdateProperties Wenn eine vorhandene Eigenschaft das Prädikat erfüllt, wird ihr Wert aktualisiert. Wenn im Paket eine bekannte Eigenschaft fehlt, die das Prädikat erfüllt, wird sie dem Paket hinzugefügt.
ToList() Erstellt eine Liste aus dem Paket.
UpdateProperties(Func<MetadataProperty, bool>, PropertyValue) Aktualisiert bekannte Metadateneigenschaften, die das angegebene Prädikat erfüllen. Die Operation ist rekursiv, sodass sie sich auch auf alle verschachtelten Pakete auswirkt.

Bemerkungen

Erfahren Sie mehr

Beispiele

Dieses Beispiel zeigt, wie das ID3v2-Tag in einer MP3-Datei gelesen wird.

using (Metadata metadata = new Metadata(Constants.MP3WithID3V2))
{
    var root = metadata.GetRootPackage<MP3RootPackage>();

    if (root.ID3V2 != null)
    {
        Console.WriteLine(root.ID3V2.Album);
        Console.WriteLine(root.ID3V2.Artist);
        Console.WriteLine(root.ID3V2.Band);
        Console.WriteLine(root.ID3V2.Title);
        Console.WriteLine(root.ID3V2.Composers);
        Console.WriteLine(root.ID3V2.Copyright);
        Console.WriteLine(root.ID3V2.Publisher);
        Console.WriteLine(root.ID3V2.OriginalAlbum);
        Console.WriteLine(root.ID3V2.MusicalKey);

        if (root.ID3V2.AttachedPictures != null)
        {
            foreach (var attachedPicture in root.ID3V2.AttachedPictures)
            {
                Console.WriteLine(attachedPicture.AttachedPictureType);
                Console.WriteLine(attachedPicture.MimeType);
                Console.WriteLine(attachedPicture.Description);

                // ...
            }
        }

        // ...
    }
}

Siehe auch

ID3V2PrivateFrame ID3V2TagFrame