LyricsTag

LyricsTag class

Rappresenta i metadati di Lyrics3 v2.00. Ulteriori informazioni sono disponibili all’indirizzohttp://id3.org/Lyrics3v2 .

public sealed class LyricsTag : CustomPackage

Costruttori

Nome Descrizione
LyricsTag() Inizializza una nuova istanza diLyricsTag classe.

Proprietà

Nome Descrizione
AdditionalInfo { get; set; } Ottiene o imposta le informazioni aggiuntive. Questo valore è rappresentato dal campo INF.
Album { get; set; } Ottiene o imposta il nome dell’album. Questo valore è rappresentato dal campo EAL.
Artist { get; set; } Ottiene o imposta il nome dell’artista. Questo valore è rappresentato dal campo EAR.
Author { get; set; } Ottiene o imposta l’autore. Questo valore è rappresentato dal campo AUT.
Count { get; } Ottiene il numero di proprietà dei metadati.
Item { get; } Ottiene ilMetadataProperty con il nome specificato.
Keys { get; } Ottiene una raccolta dei nomi delle proprietà dei metadati.
Lyrics { get; set; } Recupera o imposta i testi. Questo valore è rappresentato dal campo LYR.
MetadataType { get; } Ottiene il tipo di metadati.
PropertyDescriptors { get; } Ottiene una raccolta di descrittori che contengono informazioni sulle proprietà accessibili tramite il motore di ricerca GroupDocs.Metadata.
Track { get; set; } Ottiene o imposta il titolo della traccia. Questo valore è rappresentato dal campo ETT.

Metodi

Nome Descrizione
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.
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 il valore del campo con l’id specificato.
GetEnumerator() Restituisce un enumeratore che scorre la raccolta.
Remove(string) Rimuove il campo con l’id specificato.
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(LyricsField) Aggiunge o sostituisce il campo Lyrics3 specificato.
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

Lyrics3 v2.00 utilizza i campi per rappresentare le informazioni. I dati in un campo possono essere costituiti da caratteri ASCII nell’intervallo da 01 a 254 secondo lo standard. Poiché la mappa dei caratteri ASCII è definita solo da 00 a 128 ISO-8859- 1 si potrebbe presumere. I campi numerici sono lunghi 5 o 6 caratteri, a seconda della posizione, e sono riempiti con zeri.

Saperne di più

Esempi

Questo esempio di codice mostra come leggere il tag Lyrics da un file MP3.

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

    if (root.Lyrics3V2 != null)
    {
        Console.WriteLine(root.Lyrics3V2.Lyrics);
        Console.WriteLine(root.Lyrics3V2.Album);
        Console.WriteLine(root.Lyrics3V2.Artist);
        Console.WriteLine(root.Lyrics3V2.Track);

        //...

        // In alternativa, puoi scorrere un elenco completo di campi tag
        foreach (var field in root.Lyrics3V2.ToList())
        {
            Console.WriteLine("{0} = {1}", field.ID, field.Data);
        }
    }
}

Guarda anche

LyricsField MP3RootPackage