ID3V2Tag

ID3V2Tag class

Representa una etiqueta ID3v2. Encuentre más información enhttps://en.wikipedia.org/wiki/ID3#ID3v2 .

public sealed class ID3V2Tag : ID3Tag

Constructores

Nombre Descripción
ID3V2Tag() Inicializa una nueva instancia delID3V2Tag clase.

Propiedades

Nombre Descripción
Album { get; set; } Obtiene o establece el título del álbum/película/programa. Este valor está representado por el cuadro TALB.
Artist { get; set; } Obtiene o establece el(los) artista(s) principal(es)/intérprete(s) principal(es)/solista(s)/grupo de interpretación. Este valor está representado por el cuadro TPE1.
AttachedPictures { get; set; } Obtiene o establece las imágenes adjuntas directamente relacionadas con el archivo de audio. Este valor está representado por el marco APIC.
Band { get; set; } Obtiene o establece la Banda/Orquesta/Acompañamiento. Este valor está representado por el marco TPE2.
BitsPerMinute { get; set; } Obtiene o establece el número de pulsaciones por minuto en la parte principal del audio. Este valor está representado por el marco TBPM.
Comments { get; set; } Obtiene o establece los comentarios del usuario. Este valor está representado por el marco COMM. El marco está diseñado para cualquier tipo de información de texto completo que no cabe en ningún otro marco.
Composers { get; set; } Obtiene o establece los compositores. Los nombres se separan con el carácter “/”. Este valor está representado por el marco TCOM.
ContentType { get; set; } Obtiene o establece el tipo de contenido. Este valor está representado por el marco TCON.
Copyright { get; set; } Obtiene o establece el mensaje de copyright. Este valor está representado por el marco TCOP.
Count { get; } Obtiene el número de propiedades de metadatos.
Date { get; set; } Obtiene o establece una cadena numérica en formato DDMM que contiene la fecha de la grabación. Este campo siempre tiene cuatro caracteres. Este valor está representado por el marco TDAT.
EncodedBy { get; set; } Obtiene o establece el nombre de la persona u organización que codificó el archivo de audio. Este valor está representado por el cuadro TENC.
Isrc { get; set; } Obtiene o establece el Código de grabación estándar internacional (ISRC) (12 caracteres). Este valor está representado por el marco TSRC.
Item { get; } Obtiene elMetadataProperty con el nombre especificado.
Keys { get; } Obtiene una colección de nombres de propiedades de metadatos.
LengthInMilliseconds { get; set; } Obtiene o establece la duración del archivo de audio en milisegundos, representada como una cadena numérica. Este valor está representado por el marco TLEN.
MetadataType { get; } Obtiene el tipo de metadato.
MusicalKey { get; set; } Obtiene o establece la clave musical en la que comienza el sonido. Este valor está representado por el cuadro TKEY.
OriginalAlbum { get; set; } Obtiene o establece el título original del álbum/película/programa. Este valor está representado por el cuadro TOAL.
PropertyDescriptors { get; } Obtiene una colección de descriptores que contienen información sobre propiedades accesibles a través del motor de búsqueda GroupDocs.Metadata.
Publisher { get; set; } Obtiene o establece el nombre de la etiqueta o editorial. Este valor está representado por el marco TPUB.
SizeInBytes { get; set; } Obtiene o establece el tamaño del archivo de audio en bytes, excluyendo la etiqueta ID3v2, representada como una cadena numérica. Este valor está representado por el marco TSIZ.
SoftwareHardware { get; set; } Obtiene o establece el codificador de audio usado y su configuración cuando se codificó el archivo. Este valor está representado por el marco TSSE.
Subtitle { get; set; } Obtiene o establece el refinamiento de Subtítulo/Descripción. Este valor está representado por el marco TIT3.
TagSize { get; } Obtiene el tamaño de la etiqueta.
Time { get; set; } Obtiene o establece una cadena numérica en formato HHMM que contiene la hora de la grabación. Este campo siempre tiene cuatro caracteres. Este valor está representado por el marco TIME.
Title { get; set; } Obtiene o establece el Título/Nombre de la canción/Descripción del contenido. Este valor está representado por el cuadro TIT2.
TrackNumber { get; set; } Obtiene o establece una cadena numérica que contiene el número de orden del archivo de audio en su grabación original. Este valor está representado por el cuadro TRCK.
TrackPlayCounter { get; } Obtiene el número de veces que se ha reproducido el archivo. Este valor está representado por el marco PCNT.
override Version { get; } Obtiene la versión ID3.
Year { get; set; } Obtiene o establece una cadena numérica con un año de la grabación. Este marco siempre tiene cuatro caracteres (hasta el año 10000). Este valor está representado por el marco TYER.

Métodos

Nombre Descripción
Add(ID3V2TagFrame) Agrega un marco a la etiqueta.
AddProperties(Func<MetadataProperty, bool>, PropertyValue) Agrega propiedades de metadatos conocidas que satisfacen el predicado especificado. La operación es recursiva, por lo que también afecta a todos los paquetes anidados.
Clear(string) Elimina todos los fotogramas con el id especificado.
Contains(string) Determina si el paquete contiene una propiedad de metadatos con el nombre especificado.
virtual FindProperties(Func<MetadataProperty, bool>) Encuentra las propiedades de metadatos que satisfacen el predicado especificado. La búsqueda es recursiva, por lo que también afecta a todos los paquetes anidados.
Get(string) Obtiene una matriz de fotogramas con el id especificado.
GetEnumerator() Devuelve un enumerador que itera a través de la colección.
Remove(ID3V2TagFrame) Elimina el marco especificado de la etiqueta.
RemoveAttachedPictures() Elimina todas las imágenes adjuntas almacenadas en marcos APIC.
virtual RemoveProperties(Func<MetadataProperty, bool>) Elimina las propiedades de metadatos que cumplen el predicado especificado.
virtual Sanitize() Elimina las propiedades de metadatos de escritura del paquete. La operación es recursiva, por lo que también afecta a todos los paquetes anidados.
Set(ID3V2TagFrame) Elimina todos los marcos que tengan el mismo id que el especificado y agrega el nuevo marco a la etiqueta.
SetProperties(Func<MetadataProperty, bool>, PropertyValue) Establece propiedades de metadatos conocidas que satisfacen el predicado especificado. La operación es recursiva, por lo que también afecta a todos los paquetes anidados. Este método es una combinación deAddProperties yUpdateProperties Si una propiedad existente satisface el predicado, su valor se actualiza. Si falta una propiedad conocida en el paquete que satisface el predicado, se agrega al paquete.
ToList() Crea una lista a partir del paquete.
UpdateProperties(Func<MetadataProperty, bool>, PropertyValue) Actualiza las propiedades de metadatos conocidas que satisfacen el predicado especificado. La operación es recursiva, por lo que también afecta a todos los paquetes anidados.

Observaciones

Aprende más

Ejemplos

Este ejemplo muestra cómo leer la etiqueta ID3v2 en un archivo 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);

                // ...
            }
        }

        // ...
    }
}

Ver también