ID3V2Tag

ID3V2Tag class

Représente une balise ID3v2. Veuillez trouver plus d’informations surhttps://en.wikipedia.org/wiki/ID3#ID3v2 .

public sealed class ID3V2Tag : ID3Tag

Constructeurs

Nom La description
ID3V2Tag() Initialise une nouvelle instance duID3V2Tag classe.

Propriétés

Nom La description
Album { get; set; } Obtient ou définit le titre de l’album/film/émission. Cette valeur est représentée par le cadre TALB.
Artist { get; set; } Obtient ou définit le(s) artiste(s) principal(aux)/interprète(s) principal(aux)/soliste(s)/groupe d’interprétation. Cette valeur est représentée par le cadre TPE1.
AttachedPictures { get; set; } Obtient ou définit les images jointes directement liées au fichier audio. Cette valeur est représentée par le cadre APIC.
Band { get; set; } Obtient ou définit le groupe/l’orchestre/l’accompagnement. Cette valeur est représentée par la trame TPE2.
BitsPerMinute { get; set; } Obtient ou définit le nombre de battements par minute dans la partie principale de l’audio. Cette valeur est représentée par l’image TBPM.
Comments { get; set; } Obtient ou définit les commentaires de l’utilisateur. Cette valeur est représentée par le cadre COMM. Le cadre est destiné à tout type d’informations en texte intégral qui ne rentrent dans aucun autre cadre.
Composers { get; set; } Obtient ou définit les compositeurs. Les noms sont séparés par le caractère “/”. Cette valeur est représentée par la trame TCOM.
ContentType { get; set; } Obtient ou définit le type de contenu. Cette valeur est représentée par la trame TCON.
Copyright { get; set; } Obtient ou définit le message de copyright. Cette valeur est représentée par la trame TCPP.
Count { get; } Obtient le nombre de propriétés de métadonnées.
Date { get; set; } Obtient ou définit une chaîne numérique au format JJMM contenant la date de l’enregistrement. Ce champ comporte toujours quatre caractères. Cette valeur est représentée par la trame TDAT.
EncodedBy { get; set; } Obtient ou définit le nom de la personne ou de l’organisation qui a encodé le fichier audio. Cette valeur est représentée par le cadre TENC.
Isrc { get; set; } Obtient ou définit le code ISRC (International Standard Recording Code) (12 caractères). Cette valeur est représentée par la trame TSRC.
Item { get; } Obtient leMetadataProperty avec le nom spécifié.
Keys { get; } Obtient une collection des noms de propriétés de métadonnées.
LengthInMilliseconds { get; set; } Obtient ou définit la longueur du fichier audio en millisecondes, représentée sous la forme d’une chaîne numérique. Cette valeur est représentée par la trame TLEN.
MetadataType { get; } Obtient le type de métadonnées.
MusicalKey { get; set; } Obtient ou définit la tonalité musicale dans laquelle le son commence. Cette valeur est représentée par le cadre TKEY.
OriginalAlbum { get; set; } Obtient ou définit le titre original de l’album/film/émission. Cette valeur est représentée par le cadre TOAL.
PropertyDescriptors { get; } Obtient une collection de descripteurs contenant des informations sur les propriétés accessibles via le moteur de recherche GroupDocs.Metadata.
Publisher { get; set; } Obtient ou définit le nom du label ou de l’éditeur. Cette valeur est représentée par le cadre TPUB.
SizeInBytes { get; set; } Obtient ou définit la taille du fichier audio en octets, à l’exclusion de la balise ID3v2, représentée sous la forme d’une chaîne numérique. Cette valeur est représentée par le cadre TSIZ.
SoftwareHardware { get; set; } Obtient ou définit l’encodeur audio utilisé et ses paramètres lorsque le fichier a été encodé. Cette valeur est représentée par la trame TSSE.
Subtitle { get; set; } Obtient ou définit le raffinement des sous-titres/descriptions. Cette valeur est représentée par le cadre TIT3.
TagSize { get; } Obtient la taille de la balise.
Time { get; set; } Obtient ou définit une chaîne numérique au format HHMM contenant l’heure de l’enregistrement. Ce champ comporte toujours quatre caractères. Cette valeur est représentée par la trame TIME.
Title { get; set; } Obtient ou définit le titre/le nom de la chanson/la description du contenu. Cette valeur est représentée par le cadre TIT2.
TrackNumber { get; set; } Obtient ou définit une chaîne numérique contenant le numéro d’ordre du fichier audio sur son enregistrement d’origine. Cette valeur est représentée par la trame TRCK.
TrackPlayCounter { get; } Obtient le nombre de fois que le fichier a été lu. Cette valeur est représentée par la trame PCNT.
override Version { get; } Obtient la version ID3.
Year { get; set; } Obtient ou définit une chaîne numérique avec une année d’enregistrement. Cette trame comporte toujours quatre caractères (jusqu’à l’an 10000). Cette valeur est représentée par la trame TYER.

Méthodes

Nom La description
Add(ID3V2TagFrame) Ajoute un cadre au tag.
AddProperties(Func<MetadataProperty, bool>, PropertyValue) Ajoute des propriétés de métadonnées connues satisfaisant le prédicat spécifié. L’opération est récursive, elle affecte donc également tous les packages imbriqués.
Clear(string) Supprime tous les cadres avec l’identifiant spécifié.
Contains(string) Détermine si le package contient une propriété de métadonnées avec le nom spécifié.
virtual FindProperties(Func<MetadataProperty, bool>) Trouve les propriétés de métadonnées satisfaisant le prédicat spécifié. La recherche est récursive, elle affecte donc également tous les packages imbriqués.
Get(string) Obtient un tableau de cadres avec l’identifiant spécifié.
GetEnumerator() Renvoie un énumérateur qui parcourt la collection.
Remove(ID3V2TagFrame) Supprime le cadre spécifié de la balise.
RemoveAttachedPictures() Supprime toutes les images jointes stockées dans les cadres APIC.
virtual RemoveProperties(Func<MetadataProperty, bool>) Supprime les propriétés de métadonnées satisfaisant le prédicat spécifié.
virtual Sanitize() Supprime les propriétés de métadonnées inscriptibles du package. L’opération est récursive, elle affecte donc également tous les packages imbriqués.
Set(ID3V2TagFrame) Supprime tous les cadres ayant le même identifiant que celui spécifié et ajoute le nouveau cadre à la balise.
SetProperties(Func<MetadataProperty, bool>, PropertyValue) Définit les propriétés de métadonnées connues satisfaisant le prédicat spécifié. L’opération est récursive et affecte donc également tous les packages imbriqués. Cette méthode est une combinaison deAddProperties etUpdateProperties Si une propriété existante satisfait le prédicat, sa valeur est mise à jour. S’il manque une propriété connue dans le package qui satisfait le prédicat, elle est ajoutée au package.
ToList() Crée une liste à partir du package.
UpdateProperties(Func<MetadataProperty, bool>, PropertyValue) Met à jour les propriétés de métadonnées connues satisfaisant le prédicat spécifié. L’opération est récursive et affecte donc également tous les packages imbriqués.

Remarques

Apprendre encore plus

Exemples

Cet exemple montre comment lire la balise ID3v2 dans un fichier MP3.

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);

                // ...
            }
        }

        // ...
    }
}

Voir également