EPUB עריכת מטא נתונים באמצעות C# .NET

קובץ EPUB הוא פורמט ספר אלקטרוני דיגיטלי המכיל טקסט, תמונות ורכיבי מולטימדיה, המעוצבים באמצעות טכנולוגיות אינטרנט סטנדרטיות כמו HTML ו-CSS. מטא נתונים של EPUB מתייחסים למידע חיוני המוטבע בתוך קובצי EPUB, כולל פרטים כמו כותרת, מחבר, מוציא לאור ושפה, המאפשרים קיטלוג וארגון מדויקים של ספרים דיגיטליים. במאמר זה, נדון כיצד לקרוא, לערוך ולעדכן ערכי מטא נתונים של EPUB באופן תכנותי, כולל ערכת הפריטים Dublin Core באמצעות C#.

להלן קישורים מהירים לנושאים המכוסים:

NET API לעריכת מטא נתונים

GroupDocs.Metadata מספק .NET API לאוטומטי של ניהול מטא נתונים של פורמטים שונים של קבצים בתוך יישומי NET. ה-API מאפשר לקרוא, לעדכן, להוסיף, לנקות ולהסיר את המטא נתונים עבור פורמטים רבים של קבצים. היום, נשתמש ב-API זה כדי להתמודד עם מטא נתונים של ספרים אלקטרוניים בפורמט EPUB.

אתה יכול להוריד את קובצי ה-DLL או ה-MSI מתקין מסעיף ההורדות או להתקין את ה-API באפליקציית NET שלך דרך NuGet.

PM> Install-Package GroupDocs.Metadata

שינוי מטא נתונים של EPUB עם C#

אם ברצונך לשנות את מאפייני המטא נתונים של EPUB כמפתח .NET, כך תוכל לעשות זאת:

  • טען את הספר האלקטרוני EPUB באמצעות המחלקה Metadata.
  • חלץ את חבילת השורש של המטא נתונים באמצעות שיטת GetRootPackage.
  • כעת אתה יכול לשלוף בקלות כדי להציג את כל מאפייני המטא נתונים של חבילת EPUB.
  • עדכן את ערכי הנכס כנדרש.
  • שמור את קובץ הספר האלקטרוני עם ערכי המטא נתונים המעודכנים בשיטת השמירה.

להלן הקטעים הקצרים של קוד C# המציגים את השלבים לעיל לקריאה ועדכון של מאפייני המטא נתונים של EPUB:

קרא מטא נתונים של EPUB

// קרא מטא נתונים של EPUB באמצעות C#
using (Metadata metadata = new Metadata("path/ebook.epub"))
{
    var root = metadata.GetRootPackage<EpubRootPackage>();

    Console.WriteLine(root.EpubPackage.Version);
    Console.WriteLine(root.EpubPackage.UniqueIdentifier);
    Console.WriteLine(root.EpubPackage.ImageCover != null ? root.EpubPackage.ImageCover.Length : 0);
    Console.WriteLine(root.EpubPackage.Description);
    Console.WriteLine(root.EpubPackage.Title);
}

עדכן מטא נתונים של EPUB

קוד המקור של C# הבא מביא ומעדכן את מאפייני המטא-נתונים של EPUB של קובץ ה-EPUB.

// עדכן מטא נתונים של EPUB באמצעות C#
using (Metadata metadata = new Metadata("path/ebook.epub"))
{
    var root = metadata.GetRootPackage<EpubRootPackage>();

    root.EpubPackage.Creator = "GroupDocs";
    root.EpubPackage.Description = "metadata updated e-book";
    root.EpubPackage.Format = "EPUB";
    root.EpubPackage.Date = DateTime.Now.ToString();
 
    metadata.Save("path/ebook.epub");
}

שינוי מטא נתונים EPUB Dublin Core עם C#

Dublin Core מטא נתונים הם מספר פריטים המתארים את המשאבים הפיזיים והדיגיטליים. אתה יכול לשנות בקלות את מאפייני המטא נתונים של Dublin Core באמצעות קוד C# דומה מאוד.

קרא את ליבת דבלין

השורות הבאות מחלצות פריטי מטא נתונים של Dublin Core לניתוח:

// קרא מטא נתונים של Dublin Core באמצעות C#
using (Metadata metadata = new Metadata("path/ebook.epub"))
{
    var root = metadata.GetRootPackage<EpubRootPackage>();

    Console.WriteLine(root.DublinCorePackage.Rights);
    Console.WriteLine(root.DublinCorePackage.Publisher);
    Console.WriteLine(root.DublinCorePackage.Title);
    Console.WriteLine(root.DublinCorePackage.Creator);
    Console.WriteLine(root.DublinCorePackage.Language);
    Console.WriteLine(root.DublinCorePackage.Date);
}

עדכן את ליבת דבלין

לאחר מכן תוכל לשנות מאפיינים ספציפיים של Dublin Core בהתאם, כפי שמוצג בקוד שלהלן:

// עדכן מטא נתונים של Dublin Core באמצעות C#
using (Metadata metadata = new Metadata("path/ebook.epub"))
{
    var root = metadata.GetRootPackage<EpubRootPackage>();

    root.DublinCorePackage.SetProperties(p => p.Name == "dc:creator", new PropertyValue("GroupDocs"));
    root.DublinCorePackage.SetProperties(p => p.Name == "dc:description", new PropertyValue("metadata updated e-book"));
    root.DublinCorePackage.SetProperties(p => p.Name == "dc:title", new PropertyValue("Sample EPUB"));
    root.DublinCorePackage.SetProperties(p => p.Name == "dc:date", new PropertyValue(DateTime.Now.ToString()));

    metadata.Save("path/ebook.epub");
}

קבלת רישיון חינם

אם אתה רוצה לחוות את השמחה של ממשק API זה במלוא קיבולתו, אתה יכול לקבל רישיון זמני בחינם.

סיכום

במאמר זה, חקרנו את עולם המניפולציה של מטא נתונים של EPUB. ראשית, אנו חוקרים כיצד לקרוא ולערוך מאפייני מטא נתונים של EPUB באופן תוכניתי באמצעות C#. אחר כך עשינו את אותו הדבר עבור ערכת הפריטים של Dublin Core עבור הספרים האלקטרוניים.

למידע מפורט על API, הקוראים מוזמנים לעיין במאגר Reference API, GitHub ותיעוד.

ניתן להפנות שאלות ודיונים נוספים לפורום המסופק.

ראה גם