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 search engine .
Publisher { get; set; } الحصول على أو تحديد اسم الملصق أو الناشر. يتم تمثيل هذه القيمة بواسطة إطار TPUB .
SizeInBytes { get; set; } الحصول على أو تحديد حجم الملف الصوتي بالبايت ، باستثناء علامة ID3v2 ، الممثلة كسلسلة رقمية. يتم تمثيل هذه القيمة بإطار TSIZ.
SoftwareHardware { get; set; } الحصول على أو تعيين برنامج تشفير الصوت المستخدم وإعداداته عند ترميز الملف. يتم تمثيل هذه القيمة بواسطة إطار TSSE.
Subtitle { get; set; } الحصول على أو تعيين تحسين الترجمة / الوصف. يتم تمثيل هذه القيمة بواسطة إطار TIT3.
TagSize { get; } يحصل على حجم العلامة .
Time { get; set; } الحصول على أو تعيين سلسلة رقمية بتنسيق HHMM تحتوي على وقت التسجيل. يتكون هذا الحقل دائمًا من أربعة أحرف . يتم تمثيل هذه القيمة بإطار الوقت.
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