ID3V2Tag

ID3V2Tag class

Representerar en ID3v2-tagg. Mer information finns påhttps://en.wikipedia.org/wiki/ID3#ID3v2 .

public sealed class ID3V2Tag : ID3Tag

Konstruktörer

namn Beskrivning
ID3V2Tag() Initierar en ny instans avID3V2Tag class.

Egenskaper

namn Beskrivning
Album { get; set; } Hämtar eller ställer in albumets/filmens/showtiteln. Detta värde representeras av TALB-ramen.
Artist { get; set; } Hämtar eller ställer in huvudartist(erna)/lead artist(er)/solister/uppträdande grupp. Detta värde representeras av TPE1-ramen.
AttachedPictures { get; set; } Hämtar eller ställer in de bifogade bilderna direkt relaterade till ljudfilen. Detta värde representeras av APIC-ramen.
Band { get; set; } Hämtar eller ställer in bandet/orkestern/ackompanjemanget. Detta värde representeras av TPE2-ramen.
BitsPerMinute { get; set; } Hämtar eller ställer in antalet slag per minut i huvuddelen av ljudet. Detta värde representeras av TBPM-ramen.
Comments { get; set; } Hämtar eller ställer in användarkommentarer. Detta värde representeras av COMM-ramen. Ramen är avsedd för all typ av fulltextinformation som inte passar i någon annan ram.
Composers { get; set; } Hämtar eller sätter kompositörerna. Namnen separeras med tecknet “/”. Detta värde representeras av TCOM-ramen.
ContentType { get; set; } Hämtar eller ställer in innehållstypen. Detta värde representeras av TCON-ramen.
Copyright { get; set; } Hämtar eller ställer in copyrightmeddelandet. Detta värde representeras av TCOP-ramen.
Count { get; } Hämtar antalet metadataegenskaper.
Date { get; set; } Hämtar eller ställer in en numerisk sträng i DDMM-formatet som innehåller datumet för inspelningen. Detta fält är alltid fyra tecken långt. Detta värde representeras av TDAT-ramen.
EncodedBy { get; set; } Hämtar eller ställer in namnet på personen eller organisationen som kodade ljudfilen. Detta värde representeras av TENC-ramen.
Isrc { get; set; } Hämtar eller ställer in International Standard Recording Code (ISRC) (12 tecken). Detta värde representeras av TSRC-ramen.
Item { get; } FårMetadataProperty med det angivna namnet.
Keys { get; } Hämtar en samling av metadataegenskapsnamnen.
LengthInMilliseconds { get; set; } Hämtar eller ställer in längden på ljudfilen i millisekunder, representerad som en numerisk sträng. Detta värde representeras av TLEN-ramen.
MetadataType { get; } Hämtar metadatatypen.
MusicalKey { get; set; } Hämtar eller ställer in den musikaliska nyckeln där ljudet börjar. Detta värde representeras av TKEY-ramen.
OriginalAlbum { get; set; } Hämtar eller ställer in originalalbumets/filmens/showtiteln. Detta värde representeras av TOAL-ramen.
PropertyDescriptors { get; } Får en samling beskrivningar som innehåller information om egenskaper som är tillgängliga via sökmotorn GroupDocs.Metadata.
Publisher { get; set; } Hämtar eller ställer in namnet på etiketten eller utgivaren. Detta värde representeras av TPUB-ramen.
SizeInBytes { get; set; } Hämtar eller ställer in storleken på ljudfilen i byte, exklusive ID3v2-taggen, representerad som en numerisk sträng. Detta värde representeras av TSIZ-ramen.
SoftwareHardware { get; set; } Hämtar eller ställer in den använda ljudkodaren och dess inställningar när filen kodades. Detta värde representeras av TSSE-ramen.
Subtitle { get; set; } Hämtar eller ställer in undertext/beskrivningsförfining. Detta värde representeras av TIT3-ramen.
TagSize { get; } Hämtar storleken på taggen.
Time { get; set; } Hämtar eller ställer in en numerisk sträng i formatet HHMM som innehåller tiden för inspelningen. Detta fält är alltid fyra tecken långt. Detta värde representeras av TIME-ramen.
Title { get; set; } Hämtar eller ställer in titel/låtnamn/innehållsbeskrivning. Detta värde representeras av TIT2-ramen.
TrackNumber { get; set; } Hämtar eller ställer in en numerisk sträng som innehåller ordningsnumret för ljudfilen på dess ursprungliga inspelning. Detta värde representeras av TRCK-ramen.
TrackPlayCounter { get; } Hämtar antalet gånger filen har spelats. Detta värde representeras av PCNT-ramen.
override Version { get; } Hämtar ID3-versionen.
Year { get; set; } Hämtar eller ställer in en numerisk sträng med ett år för inspelningen. Dessa ramar är alltid fyra tecken långa (till år 10000). Detta värde representeras av TYER-ramen.

Metoder

namn Beskrivning
Add(ID3V2TagFrame) Lägger till en ram till taggen.
AddProperties(Func<MetadataProperty, bool>, PropertyValue) Lägger till kända metadataegenskaper som uppfyller det angivna predikatet. Operationen är rekursiv så den påverkar även alla kapslade paket.
Clear(string) Tar bort alla ramar med angivet id.
Contains(string) Bestämmer om paketet innehåller en metadataegenskap med det angivna namnet.
virtual FindProperties(Func<MetadataProperty, bool>) Hittar metadataegenskaperna som uppfyller det angivna predikatet. Sökningen är rekursiv så den påverkar också alla kapslade paket.
Get(string) Får en array av ramar med det angivna id.
GetEnumerator() Returnerar en uppräkning som itererar genom samlingen.
Remove(ID3V2TagFrame) Tar bort den angivna ramen från taggen.
RemoveAttachedPictures() Tar bort alla bifogade bilder lagrade i APIC-ramar.
virtual RemoveProperties(Func<MetadataProperty, bool>) Tar bort metadataegenskaper som uppfyller det angivna predikatet.
virtual Sanitize() Tar bort skrivbara metadataegenskaper från paketet. Operationen är rekursiv så den påverkar alla kapslade paket också.
Set(ID3V2TagFrame) Tar bort alla ramar som har samma id som den angivna och lägger till den nya ramen i taggen.
SetProperties(Func<MetadataProperty, bool>, PropertyValue) Ställer in kända metadataegenskaper som uppfyller det angivna predikatet. Operationen är rekursiv så den påverkar också alla kapslade paket. Denna metod är en kombination avAddProperties ochUpdateProperties Om en befintlig egenskap uppfyller predikatet uppdateras dess värde. Om det saknas en känd egenskap i paketet som uppfyller predikatet läggs den till i paketet.
ToList() Skapar en lista från paketet.
UpdateProperties(Func<MetadataProperty, bool>, PropertyValue) Uppdaterar kända metadataegenskaper som uppfyller det angivna predikatet. Operationen är rekursiv så den påverkar också alla kapslade paket.

Anmärkningar

Läs mer

Exempel

Det här exemplet visar hur man läser ID3v2-taggen i en MP3-fil.

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

                // ...
            }
        }

        // ...
    }
}

Se även