ID3V2Tag

ID3V2Tag class

Представляет тег ID3v2. Дополнительную информацию см.https://en.wikipedia.org/wiki/ID3#ID3v2 .

public sealed class ID3V2Tag : ID3Tag

Конструкторы

Имя Описание
ID3V2Tag() Инициализирует новый экземплярID3V2Tag класс.

Характеристики

Имя Описание
Album { get; set; } Получает или задает название альбома/фильма/шоу. Это значение представлено кадром TALB.
Artist { get; set; } Получает или задает ведущего исполнителя(ей)/ведущего исполнителя(ей)/солиста(ов)/группу исполнителей. Это значение представлено фреймом TPE1.
AttachedPictures { get; set; } Получает или задает прикрепленные изображения, непосредственно связанные с аудиофайлом. Это значение представлено кадром APIC.
Band { get; set; } Получает или устанавливает полосу/оркестр/аккомпанемент. Это значение представлено кадром TPE2.
BitsPerMinute { get; set; } Получает или задает количество ударов в минуту в основной части аудио. Это значение представлено кадром TBPM.
Comments { get; set; } Получает или задает пользовательские комментарии. Это значение представлено фреймом COMM. Фрейм предназначен для любой полнотекстовой информации, которая не помещается ни в какой другой фрейм.
Composers { get; set; } Получает или задает композиторов. Имена разделяются символом “/”. Это значение представлено кадром TCOM.
ContentType { get; set; } Получает или задает тип содержимого. Это значение представлено кадром TCON.
Copyright { get; set; } Получает или устанавливает сообщение об авторских правах. Это значение представлено кадром TCOP.
Count { get; } Получает количество свойств метаданных.
Date { get; set; } Получает или задает числовую строку в формате DDMM, содержащую дату записи. Это поле всегда состоит из четырех символов. Это значение представлено кадром TDAT.
EncodedBy { get; set; } Получает или задает имя человека или организации, которые закодировали аудиофайл. Это значение представлено кадром TENC.
Isrc { get; set; } Получает или задает Международный стандартный код записи (ISRC) (12 символов). Это значение представлено кадром TSRC.
Item { get; } ПолучаетMetadataProperty с указанным именем.
Keys { get; } Получает коллекцию имен свойств метаданных.
LengthInMilliseconds { get; set; } Получает или задает длину аудиофайла в миллисекундах, представленную в виде числовой строки. Это значение представлено кадром TLEN.
MetadataType { get; } Получает тип метаданных.
MusicalKey { get; set; } Получает или устанавливает музыкальную тональность, в которой начинается звук. Это значение представлено кадром TKEY.
OriginalAlbum { get; set; } Получает или задает исходное название альбома/фильма/шоу. Это значение представлено кадром TOAL.
PropertyDescriptors { get; } Получает набор дескрипторов, содержащих информацию о свойствах, доступных через поисковую систему GroupDocs.Metadata.
Publisher { get; set; } Получает или задает имя лейбла или издателя. Это значение представлено кадром TPUB.
SizeInBytes { get; set; } Получает или задает размер аудиофайла в байтах, исключая тег ID3v2, представленный в виде числовой строки. Это значение представлено кадром TSIZ.
SoftwareHardware { get; set; } Получает или задает используемый аудиокодер и его настройки при кодировании файла. Это значение представлено кадром TSSE.
Subtitle { get; set; } Получает или задает уточнение подзаголовка/описания. Это значение представлено кадром TIT3.
TagSize { get; } Получает размер тега.
Time { get; set; } Получает или задает числовую строку в формате ЧЧММ, содержащую время записи. Это поле всегда состоит из четырех символов. Это значение представлено кадром TIME.
Title { get; set; } Получает или задает заголовок/название песни/описание содержимого. Это значение представлено кадром TIT2.
TrackNumber { get; set; } Получает или задает числовую строку, содержащую порядковый номер аудиофайла в его исходной записи. Это значение представлено кадром TRCK.
TrackPlayCounter { get; } Получает количество воспроизведений файла. Это значение представлено кадром PCNT.
override Version { get; } Получает версию ID3.
Year { get; set; } Получает или задает числовую строку с годом записи. Этот кадр всегда состоит из четырех символов (до 10000 года). Это значение представлено кадром TYER.

Методы

Имя Описание
Add(ID3V2TagFrame) Добавляет рамку к тегу.
AddProperties(Func<MetadataProperty, bool>, PropertyValue) Добавляет известные свойства метаданных, удовлетворяющие указанному предикату. Операция является рекурсивной, поэтому она также влияет на все вложенные пакеты.
Clear(string) Удаляет все кадры с указанным идентификатором.
Contains(string) Определяет, содержит ли пакет свойство метаданных с указанным именем.
virtual FindProperties(Func<MetadataProperty, bool>) Находит свойства метаданных, удовлетворяющие указанному предикату. Поиск является рекурсивным, поэтому он затрагивает также все вложенные пакеты.
Get(string) Получает массив кадров с указанным идентификатором.
GetEnumerator() Возвращает перечислитель, который выполняет итерацию по коллекции.
Remove(ID3V2TagFrame) Удаляет указанный кадр из тега.
RemoveAttachedPictures() Удаляет все прикрепленные изображения, хранящиеся в кадрах APIC.
virtual RemoveProperties(Func<MetadataProperty, bool>) Удаляет свойства метаданных, удовлетворяющие указанному предикату.
virtual Sanitize() Удаляет доступные для записи свойства метаданных из пакета. Операция является рекурсивной, поэтому она также влияет на все вложенные пакеты.
Set(ID3V2TagFrame) Удаляет все кадры с таким же идентификатором, как указанный, и добавляет новый кадр в тег.
SetProperties(Func<MetadataProperty, bool>, PropertyValue) Устанавливает известные свойства метаданных, удовлетворяющие указанному предикату. Операция является рекурсивной, поэтому она влияет также на все вложенные пакеты. Этот метод представляет собой комбинациюAddProperties иUpdateProperties Если существующее свойство удовлетворяет предикату, его значение обновляется. Если в пакете отсутствует известное свойство, удовлетворяющее предикату, оно добавляется в пакет.
ToList() Создает список из пакета.
UpdateProperties(Func<MetadataProperty, bool>, PropertyValue) Обновляет известные свойства метаданных, удовлетворяющие указанному предикату. Операция является рекурсивной, поэтому она также влияет на все вложенные пакеты.

Примечания

Узнать больше

Примеры

В этом примере показано, как прочитать тег ID3v2 в файле 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);

                // ...
            }
        }

        // ...
    }
}

Смотрите также

ID3V2PrivateFrame ID3V2TagFrame