إنشاء رمز شريطي في مستندات Word باستخدام C#

الرموز الشريطية هي صور في شكل خطوط متوازية أو نقاط أو مستطيلات مع بيانات / معلومات مشفرة. يقوم المتخصصون في الصناعة بتضمين معلومات المنتج والوصول إليها وتتبع حركة المنتج ومواكبة المخزون باستخدام الرموز الشريطية. في بعض الحالات ، قد نحتاج إلى إنشاء رموز شريطية وإضافتها في مستندات MS Word. MS Word هو برنامج معالجة الكلمات الرسومية الأكثر شيوعًا والأكثر استخدامًا. يتم استخدامه لإنشاء مستندات جديدة تحتوي على نصوص أو صور أو رسومات ، وكتابة عمليات كتابة بجودة احترافية ، وتحرير وتنسيق المستندات الحالية ، إلخ. تنسيقات الملفات التي يدعمها MS Word. في هذه المقالة ، سوف نتعلم كيفية إنشاء رمز شريطي في مستندات Word برمجيًا باستخدام C#.

سيتم تناول الموضوعات التالية في هذه المقالة:

C# API لإنشاء رمز شريطي في مستندات Word

لإنشاء رمز شريطي وإضافة صورة باركود إلى مستندات Word ، سوف نتبع إجراء من خطوتين. أولاً ، سنستخدم واجهة برمجة تطبيقات Aspose.Words for .NET لإنشاء أو تحميل مستند Word ، ثم سننشئ ونضيف صورة الرمز الشريطي إلى المستند باستخدام [Aspose.BarCode for .NET] 4 API. تسمح فئة Document من Aspose.Words for .NET API بإنشاء مستند Word جديد أو تحميل ملف Word موجود في التطبيق. طريقة Save() لهذه الفئة تحفظ المستند على مسار الملف المحدد. توفر فئة DocumentBuilder الخاصة بواجهة برمجة التطبيقات طرقًا لبناء مستند. يوفر العديد من الأساليب InsertImage() المحملة بشكل زائد لإدراج صورة في المستند.

يسمح Aspose.BarCode لـ .NET API بتوليد أنواع مختلفة من الرموز الشريطية المدعومة. لهذا الغرض ، فإنه يوفر فئة BarcodeGenerator لتوليد الرمز الشريطي الخاص بـ EncodeType المحدد. يمكننا حفظ صورة الباركود التي تم إنشاؤها باستخدام طريقة Save() لهذه الفئة. توفر API أيضًا تعداد BarCodeImageFormat لتحديد تنسيقات الحفظ. يمكننا قراءة الباركود من الصور باستخدام فئة BarCodeReader من API.

يرجى إما تنزيل مكتبات DLL الخاصة بواجهات برمجة التطبيقات أو تثبيتها باستخدام NuGet.

PM> Install-Package Aspose.BarCode
PM> Install-Package Aspose.Words

إنشاء وإضافة رمز شريطي إلى مستند Word في C#

يمكننا إنشاء مستند Word جديد وإضافة صورة الباركود إلى المستند باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل لفئة BarcodeGenerator. يستغرق EncodeType والنص للترميز كوسائط.
  2. بعد ذلك ، قم بإنشاء مثيل لكائن دفق الذاكرة.
  3. ثم ، قم باستدعاء طريقة Save() لحفظ صورة الرمز الشريطي في تدفق الذاكرة.
  4. بعد ذلك ، قم بإنشاء مثيل لفئة المستند.
  5. بعد ذلك ، قم بتهيئة مثيل لفئة DocumentBuilder مع كائن المستند.
  6. بعد ذلك ، أدخل صورة الرمز الشريطي باستخدام طريقة InsertImage() مع كائن الدفق كوسيطة.
  7. أخيرًا ، قم باستدعاء طريقة Save().يأخذ مسار ملف DOCX الناتج كوسيطة.

يوضح المثال التالي من التعليمات البرمجية كيفية إنشاء رمز شريطي وإضافته إلى مستند Word جديد باستخدام C#.

// يوضح مثال الرمز هذا كيفية إنشاء صورة رمز شريطي وإضافتها إلى مستند Word.
// المسار إلى دليل المستندات.
string dataDir = @"C:\Files\BarCode\";

// إنشاء كائن الرمز الشريطي الخطي ، قم بتعيين نص الرمز ونوع الترميز للرمز الشريطي
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Code39Standard, "1234567890");

// إنشاء دفق الذاكرة وحفظ صورة الرمز الشريطي في تدفق الذاكرة
Stream ms = new MemoryStream();
generator.Save(ms, BarCodeImageFormat.Bmp);

// قم بإنشاء مستند Word جديد
Aspose.Words.Document doc = new Aspose.Words.Document();

// إنشاء منشئ لكائن الوثيقة
DocumentBuilder builder = new DocumentBuilder(doc);

// أدخل صورة الرمز الشريطي في المستند
builder.InsertImage(ms);

// احفظ مستند الكلمة
doc.Save(dataDir + "Sample_out.docx");
قم بإنشاء وإضافة رمز شريطي إلى مستند Word جديد في C#.

قم بإنشاء وإضافة رمز شريطي إلى مستند Word جديد في C#.

إضافة رمز شريطي إلى مستند Word موجود في C#

يمكننا إنشاء صورة باركود وإضافتها إلى أي مستند Word موجود باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل لفئة BarcodeGenerator باستخدام EncodeType والنص للترميز كوسائط.
  2. بعد ذلك ، قم بإنشاء مثيل لكائن دفق الذاكرة.
  3. ثم ، قم باستدعاء طريقة Save() لحفظ صورة الرمز الشريطي في تدفق الذاكرة.
  4. بعد ذلك ، قم بتحميل مستند Word موجود باستخدام فئة المستند.
  5. بعد ذلك ، قم بتهيئة مثيل لفئة DocumentBuilder مع كائن المستند.
  6. بعد ذلك ، أدخل صورة الرمز الشريطي باستخدام طريقة InsertImage() مع كائن الدفق وموضعه كوسيطات.
  7. أخيرًا ، قم باستدعاء طريقة Save().يأخذ مسار ملف DOCX الناتج كوسيطة.

يوضح المثال التالي من التعليمات البرمجية كيفية إنشاء رمز شريطي وإضافته إلى مستند Word موجود باستخدام C#.

// يوضح مثال الرمز هذا كيفية إنشاء صورة رمز شريطي وإضافتها إلى مستند Word موجود.
// المسار إلى دليل المستندات.
string dataDir = @"C:\Files\BarCode\";

// إنشاء كائن الرمز الشريطي الخطي ، قم بتعيين نص الرمز ونوع الترميز للرمز الشريطي
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.Codabar, "1234567890");

// إنشاء دفق الذاكرة وحفظ صورة الرمز الشريطي في تدفق الذاكرة
Stream ms = new MemoryStream();
generator.Save(ms, BarCodeImageFormat.Bmp);

// قم بإنشاء مستند Word جديد
Document doc = new Document(dataDir + "sample.docx");

// إنشاء منشئ لكائن الوثيقة
DocumentBuilder builder = new DocumentBuilder(doc);

// أدخل صورة الرمز الشريطي في المستند
builder.InsertImage(ms,
    RelativeHorizontalPosition.Margin,
    0,
    RelativeVerticalPosition.Margin,
    400,
    200,
    100,
    WrapType.Square);

// احفظ مستند الكلمة
doc.Save(dataDir + "Sample_out.docx");
إضافة رمز شريطي إلى مستند Word موجود في C#.

إضافة رمز شريطي إلى مستند Word موجود في C#.

أضف QR Code إلى مستند Word باستخدام C#

وبالمثل ، يمكننا أيضًا إنشاء صورة رمز الاستجابة السريعة وإضافتها إلى مستند Word باتباع الخطوات المذكورة سابقًا. ومع ذلك ، نحتاج فقط إلى تعيين EncodeType كـ QR أو GS1QR في الخطوة الأولى. قد نحتاج أيضًا إلى ضبط موضع الصورة في الخطوة 6.

يوضح المثال التالي من التعليمات البرمجية كيفية إضافة رمز QR إلى مستند Word باستخدام C#.

// يوضح مثال الرمز هذا كيفية إنشاء وإضافة رمز QR إلى مستند Word موجود.
// المسار إلى دليل المستندات.
string dataDir = @"C:\Files\BarCode\";

// إنشاء كائن الرمز الشريطي الخطي ، قم بتعيين نص الرمز ونوع الترميز للرمز الشريطي
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.QR, "1234567");

// إنشاء دفق الذاكرة وحفظ صورة الرمز الشريطي في تدفق الذاكرة
Stream ms = new MemoryStream();
generator.Save(ms, BarCodeImageFormat.Bmp);

// قم بإنشاء مستند Word جديد
Document doc = new Document(dataDir + "sample.docx");

// إنشاء منشئ لكائن الوثيقة
DocumentBuilder builder = new DocumentBuilder(doc);

// أدخل صورة الرمز الشريطي في المستند
builder.InsertImage(ms,
    RelativeHorizontalPosition.Margin,
    400,
    RelativeVerticalPosition.Margin,
    -50,
    100,
    100,
    WrapType.Square);

// احفظ مستند الكلمة
doc.Save(dataDir + "Sample_qr_out.docx");
أضف QR Code إلى مستند Word باستخدام C#.

أضف QR Code إلى مستند Word باستخدام C#.

قراءة الباركود من مستند Word باستخدام C#

يمكننا التعرف على أي صورة باركود متاحة في أي صفحة من مستند Word باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بتحميل مستند Word موجود باستخدام فئة المستند.
  2. بعد ذلك ، قم بالوصول إلى NodeCollection من أنواع الشكل باستخدام طريقة GetChildNodes().
  3. بعد ذلك ، مرر عبر كل الأشكال وتحقق مما إذا كان الشكل عبارة عن صورة.
  4. بعد ذلك ، احفظ الصورة في الدفق.
  5. بعد ذلك ، قم بإنشاء مثيل لفئة BarCodeReader مع دفق الصورة و DecodeType كوسائط.
  6. بعد ذلك ، قم باستدعاء الأسلوب ReadBarCodes() للحصول على كائن BarCodeResult.
  7. أخيرًا ، اعرض معلومات الباركود.

يوضح المثال التالي من التعليمات البرمجية كيفية قراءة صورة الرمز الشريطي من مستند Word باستخدام C#.

// يوضح مثال الرمز هذا كيفية قراءة الباركود من مستند Word.
// المسار إلى دليل المستندات.
string dataDir = @"C:\Files\BarCode\";

// قم بتحميل مستند Word
Document wordDocument = new Document(dataDir + "sample_out.docx");

// احصل على كل الأشكال
NodeCollection shapes = wordDocument.GetChildNodes(NodeType.Shape, true);

// حلقة من خلال جميع الأشكال
foreach (Shape shape in shapes)
{
  // تحقق مما إذا كان يحتوي على صورة
  if (shape.HasImage)
  {
    // احفظ الصورة في دفق الذاكرة
    MemoryStream imgStream = new MemoryStream();
    shape.ImageData.Save(imgStream);

    // التعرف على الباركود من تدفق الصورة أعلاه
    using (BarCodeReader reader = new BarCodeReader(new Bitmap(imgStream), DecodeType.Code39Standard))
    {
      foreach (BarCodeResult result in reader.ReadBarCodes())
      {
        Console.WriteLine("Codetext found: " + result.CodeText + ", Symbology: " + result.CodeType);
      }
    }
  }
}
Codetext found: 1234567890, Symbology: Code39Standard

احصل على رخصة مجانية

يمكنك الحصول على ترخيص مؤقت مجاني لتجربة المكتبة دون قيود التقييم.

استنتاج

في هذه المقالة ، تعلمنا كيفية:

  • إنشاء مستند Word برمجيًا ؛
  • إنشاء صورة باركود وإضافتها إلى مستند Word ؛
  • قم بإنشاء رمز QR وأدخله في مستند Word ؛
  • قراءة صورة الرمز الشريطي من مستند Word في C#.

بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول Aspose.BarCode لـ .NET API باستخدام التوثيق. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا