LyricsTag

LyricsTag class

يمثل Lyrics3 v2.00 metadata. يرجى العثور على مزيد من المعلومات علىhttp://id3.org/Lyrics3v2 .

public sealed class LyricsTag : CustomPackage

المنشئون

اسم وصف
LyricsTag() يقوم بتهيئة مثيل جديد لملفLyricsTag فئة .

الخصائص

اسم وصف
AdditionalInfo { get; set; } الحصول على المعلومات الإضافية أو تعيينها. يتم تمثيل هذه القيمة بواسطة حقل INF.
Album { get; set; } الحصول على اسم الألبوم أو تحديده. يتم تمثيل هذه القيمة بواسطة حقل EAL .
Artist { get; set; } الحصول على أو تحديد اسم الفنان. يتم تمثيل هذه القيمة بواسطة حقل EAR .
Author { get; set; } الحصول على المؤلف أو تعيينه. يتم تمثيل هذه القيمة بواسطة حقل AUT .
Count { get; } الحصول على عدد خصائص البيانات الوصفية.
Item { get; } يحصل على ملفMetadataProperty بالاسم المحدد.
Keys { get; } الحصول على مجموعة من أسماء خصائص البيانات الوصفية.
Lyrics { get; set; } الحصول على أو تعيين كلمات الأغاني . يتم تمثيل هذه القيمة بواسطة حقل LYR.
MetadataType { get; } الحصول على نوع البيانات الوصفية .
PropertyDescriptors { get; } يحصل على مجموعة من الواصفات التي تحتوي على معلومات حول الخصائص التي يمكن الوصول إليها من خلال GroupDocs.Metadata search engine .
Track { get; set; } الحصول على عنوان المسار أو تعيينه. يتم تمثيل هذه القيمة بواسطة حقل ETT .

طُرق

اسم وصف
AddProperties(Func<MetadataProperty, bool>, PropertyValue) يضيف خصائص البيانات الوصفية المعروفة التي تفي بالمسند المحدد . العملية متكررة لذا فهي تؤثر على جميع الحزم المتداخلة أيضًا.
Contains(string) لتحديد ما إذا كانت الحزمة تحتوي على خاصية بيانات التعريف بالاسم المحدد.
virtual FindProperties(Func<MetadataProperty, bool>) البحث عن خصائص البيانات الوصفية التي تفي بالمسند المحدد. البحث متكرر لذا فهو يؤثر على جميع الحزم المتداخلة أيضًا.
Get(string) يحصل على قيمة الحقل بالمعرف المحدد.
GetEnumerator() إرجاع عداد يتكرر خلال المجموعة.
Remove(string) يزيل الحقل بالمعرف المحدد.
virtual RemoveProperties(Func<MetadataProperty, bool>) يزيل خصائص البيانات الوصفية التي تفي بالتقييم المحدد.
virtual Sanitize() إزالة خصائص البيانات الوصفية القابلة للكتابة من الحزمة. العملية متكررة لذا فهي تؤثر على جميع الحزم المتداخلة أيضًا.
Set(LyricsField) إضافة أو استبدال حقل Lyrics3 المحدد.
SetProperties(Func<MetadataProperty, bool>, PropertyValue) تعيين خصائص البيانات الوصفية المعروفة التي تفي بالمسند المحدد . العملية متكررة لذا فهي تؤثر على جميع الحزم المتداخلة أيضًا.AddProperties وUpdateProperties إذا كانت خاصية موجودة تحقق القيمة الأصلية ، فسيتم تحديث قيمتها. إذا كانت هناك خاصية معروفة مفقودة في الحزمة التي ترضي المسند ، فستتم إضافتها إلى الحزمة.
ToList() إنشاء قائمة من الحزمة .
UpdateProperties(Func<MetadataProperty, bool>, PropertyValue) يقوم بتحديث خصائص البيانات الوصفية المعروفة التي تفي بالمسند المحدد . العملية متكررة لذا فهي تؤثر على جميع الحزم المتداخلة أيضًا.

ملاحظات

تستخدم Lyrics3 v2.00 الحقول لتمثيل المعلومات. يمكن أن تتكون البيانات في الحقل من أحرف ASCII في النطاق من 01 إلى 254 وفقًا للمعيار . نظرًا لأن مخطط أحرف ASCII محدد فقط من 00 إلى 128 ISO-8859- 1 قد يفترض. تتكون الحقول الرقمية من 5 أو 6 أحرف ، اعتمادًا على الموقع ، ومبطنة بالأصفار.

يتعلم أكثر

أمثلة

يوضح نموذج التعليمات البرمجية هذا كيفية قراءة علامة Lyrics من ملف 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);

        // ...

        // بدلاً من ذلك ، يمكنك إجراء حلقة عبر قائمة كاملة بحقول العلامات
        foreach (var field in root.Lyrics3V2.ToList())
        {
            Console.WriteLine("{0} = {1}", field.ID, field.Data);
        }
    }
}

أنظر أيضا

LyricsField MP3RootPackage