ID3V2Tag

ID3V2Tag class

Rappresenta un tag ID3v2. Ulteriori informazioni sono disponibili all’indirizzohttps://en.wikipedia.org/wiki/ID3#ID3v2 .

public sealed class ID3V2Tag : ID3Tag

Costruttori

Nome Descrizione
ID3V2Tag() Inizializza una nuova istanza diID3V2Tag classe.

Proprietà

Nome Descrizione
Album { get; set; } Ottiene o imposta il titolo dell’album/film/programma. Questo valore è rappresentato dal frame TALB.
Artist { get; set; } Ottiene o imposta Lead artist(s)/Lead performer(s)/Soloist(s)/Performing group. Questo valore è rappresentato dal frame TPE1.
AttachedPictures { get; set; } Ottiene o imposta le immagini allegate direttamente correlate al file audio. Questo valore è rappresentato dal frame APIC.
Band { get; set; } Ottiene o imposta Banda/Orchestra/Accompagnamento. Questo valore è rappresentato dal frame TPE2.
BitsPerMinute { get; set; } Ottiene o imposta il numero di battiti al minuto nella parte principale dell’audio. Questo valore è rappresentato dal frame TBPM.
Comments { get; set; } Recupera o imposta i commenti dell’utente. Questo valore è rappresentato dal frame COMM. Il frame è destinato a qualsiasi tipo di informazione full text che non rientra in nessun altro frame.
Composers { get; set; } Ottiene o imposta i compositori. I nomi sono separati dal carattere “/”. Questo valore è rappresentato dal frame TCOM.
ContentType { get; set; } Ottiene o imposta il tipo di contenuto. Questo valore è rappresentato dal frame TCON.
Copyright { get; set; } Ottiene o imposta il messaggio di copyright. Questo valore è rappresentato dal frame TCOP.
Count { get; } Ottiene il numero di proprietà dei metadati.
Date { get; set; } Ottiene o imposta una stringa numerica nel formato DDMM contenente la data della registrazione. Questo campo è sempre lungo quattro caratteri. Questo valore è rappresentato dal frame TDAT.
EncodedBy { get; set; } Ottiene o imposta il nome della persona o dell’organizzazione che ha codificato il file audio. Questo valore è rappresentato dal frame TENC.
Isrc { get; set; } Ottiene o imposta l’ISRC (International Standard Recording Code) (12 caratteri). Questo valore è rappresentato dal frame TSRC.
Item { get; } Ottiene ilMetadataProperty con il nome specificato.
Keys { get; } Ottiene una raccolta dei nomi delle proprietà dei metadati.
LengthInMilliseconds { get; set; } Ottiene o imposta la lunghezza del file audio in millisecondi, rappresentata come una stringa numerica. Questo valore è rappresentato dal frame TLEN.
MetadataType { get; } Ottiene il tipo di metadati.
MusicalKey { get; set; } Ottiene o imposta la chiave musicale in cui inizia il suono. Questo valore è rappresentato dal frame TKEY.
OriginalAlbum { get; set; } Recupera o imposta il titolo originale dell’album/film/programma. Questo valore è rappresentato dal frame TOAL.
PropertyDescriptors { get; } Ottiene una raccolta di descrittori che contengono informazioni sulle proprietà accessibili tramite il motore di ricerca GroupDocs.Metadata.
Publisher { get; set; } Ottiene o imposta il nome dell’etichetta o dell’editore. Questo valore è rappresentato dal frame TPUB.
SizeInBytes { get; set; } Ottiene o imposta la dimensione del file audio in byte, escluso il tag ID3v2, rappresentato come una stringa numerica. Questo valore è rappresentato dal frame TSIZ.
SoftwareHardware { get; set; } Ottiene o imposta il codificatore audio utilizzato e le sue impostazioni quando il file è stato codificato. Questo valore è rappresentato dal frame TSSE.
Subtitle { get; set; } Ottiene o imposta il perfezionamento Sottotitolo/Descrizione. Questo valore è rappresentato dal frame TIT3.
TagSize { get; } Ottiene la dimensione del tag.
Time { get; set; } Ottiene o imposta una stringa numerica nel formato HHMM contenente l’ora della registrazione. Questo campo è sempre lungo quattro caratteri. Questo valore è rappresentato dal frame TIME.
Title { get; set; } Ottiene o imposta Titolo/Nome brano/Descrizione contenuto. Questo valore è rappresentato dal frame TIT2.
TrackNumber { get; set; } Ottiene o imposta una stringa numerica contenente il numero d’ordine del file audio sulla sua registrazione originale. Questo valore è rappresentato dal frame TRCK.
TrackPlayCounter { get; } Ottiene il numero di volte in cui il file è stato riprodotto. Questo valore è rappresentato dal frame PCNT.
override Version { get; } Ottiene la versione ID3.
Year { get; set; } Ottiene o imposta una stringa numerica con un anno della registrazione. Questo frame è sempre lungo quattro caratteri (fino all’anno 10000). Questo valore è rappresentato dal frame TYER.

Metodi

Nome Descrizione
Add(ID3V2TagFrame) Aggiunge una cornice al tag.
AddProperties(Func<MetadataProperty, bool>, PropertyValue) Aggiunge proprietà di metadati note che soddisfano il predicato specificato. L’operazione è ricorsiva quindi interessa anche tutti i pacchetti nidificati.
Clear(string) Rimuove tutti i frame con l’id specificato.
Contains(string) Determina se il pacchetto contiene una proprietà di metadati con il nome specificato.
virtual FindProperties(Func<MetadataProperty, bool>) Trova le proprietà dei metadati che soddisfano il predicato specificato. La ricerca è ricorsiva quindi interessa anche tutti i pacchetti nidificati.
Get(string) Ottiene un array di frame con l’id specificato.
GetEnumerator() Restituisce un enumeratore che scorre la raccolta.
Remove(ID3V2TagFrame) Rimuove il fotogramma specificato dal tag.
RemoveAttachedPictures() Rimuove tutte le immagini allegate memorizzate nei frame APIC.
virtual RemoveProperties(Func<MetadataProperty, bool>) Rimuove le proprietà dei metadati che soddisfano il predicato specificato.
virtual Sanitize() Rimuove le proprietà dei metadati scrivibili dal pacchetto. L’operazione è ricorsiva quindi interessa anche tutti i pacchetti annidati.
Set(ID3V2TagFrame) Rimuove tutti i frame con lo stesso id di quello specificato e aggiunge il nuovo frame al tag.
SetProperties(Func<MetadataProperty, bool>, PropertyValue) Imposta le proprietà dei metadati noti che soddisfano il predicato specificato. L’operazione è ricorsiva quindi interessa anche tutti i pacchetti nidificati. Questo metodo è una combinazione diAddProperties EUpdateProperties Se una proprietà esistente soddisfa il predicato, il suo valore viene aggiornato. Se nel pacchetto manca una proprietà nota che soddisfa il predicato, viene aggiunta al pacchetto.
ToList() Crea un elenco dal pacchetto.
UpdateProperties(Func<MetadataProperty, bool>, PropertyValue) Aggiorna le proprietà dei metadati noti che soddisfano il predicato specificato. L’operazione è ricorsiva quindi interessa anche tutti i pacchetti nidificati.

Osservazioni

Saperne di più

Esempi

Questo esempio mostra come leggere il tag ID3v2 in un file 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);

                //...
            }
        }

        //...
    }
}

Guarda anche

ID3V2PrivateFrame ID3V2TagFrame