فئة مكتبة COM بدون سجل لـ .NET 9 بلغة C#

في عالم البرمجة، تبرز أهمية استخدام مكتبات الفئة في تسهيل عملية تطوير التطبيقات، وخاصة عند التعامل مع تقنية COM. مع إصدار .NET 9، يوفر للمطورين إمكانية الاستفادة من مكتبات الفئة دون الحاجة لتسجيلها، مما يُعرف بالـ RegFree COM. لكن، يواجه بعض المطورين تحديات في إعداد مكتبة .NET 9 الخاصة بهم بطريقة صحيحة. سنتناول في هذا المقال كيفية التغلب على هذه التحديات.

ما هي RegFree COM في .NET 9؟

RegFree COM تعني استخدام مكونات ActiveX في نظام Windows بدون الحاجة لتسجيلها في نظام التشغيل. هذا الأمر يُعتبر ميزة هامة، حيث يسمح بتقليل التعقيدات المرتبطة بنشر التطبيقات، مما يجعلها أكثر قابلية للتحديث وسهولة في الاستخدام. تم تقديم مفهوم ComWrappers في .NET 8، مما أدى إلى تطورات جديدة في كيفية التعامل مع هذه المكتبات.

إنشاء مكتبة فئة بسيطة في .NET 9

لل شروع في إنشاء مكتبة فئة باستخدام .NET 9، يمكن استخدام الأوامر السريعة لإنشاء المشروع حيث يتم استخدام dotnet new classlib. بعد ذلك، يحتاج المطورون إلى ضبط ملف Class1.cs ليحتوي على التعليمات اللازمة. مثال:

using System.Runtime.InteropServices;
using System.Runtime.InteropServices.Marshalling;
namespace testComLib;
[GeneratedComInterface]
[Guid("e9cbe871-533e-48b5-b33f-a296a98a51cc")]
partial interface IClass1
{
    int Poke(int count);
}
[GeneratedComClass]
public partial class Class1 : IClass1
{
    public int Poke(int count) => count + 2;
}

في هذا الكود، قمنا بتعريف واجهة IClass1 وفئة Class1 التي تحقق هذه الواجهة وتوفر دالة بسيطة ترجع قيمة متزايدة.

إعداد المشروع للتوافق مع RegFree COM

لضمان عمل مكتبة الفئة بشكل صحيح دون تسجيل، يجب إعداد المشروع بشكل صحيح. يجب أن يتضمن ملف المشروع إعداد EnableRegFreeCom إلى true. هذا التعديل يتيح للمطورين إمكانية استخدام مكتبتهم في التطبيقات الأخرى بشكل سهل.

هنا مثال لكيفية ضبط ملف testComLib.csproj:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
    <EnableRegFreeCom>true</EnableRegFreeCom>
  </PropertyGroup>
</Project>

بعد القيام بكل الخطوات المطلوبة، يمكن بناء المشروع باستخدام dotnet build. بعد البناء، من المتوقع أن نجد ملف ProjectName.X.manifest في مجلد bin\Debug\net9.0\. وفي حال عدم العثور على هذا الملف، عادة ما يكون هذا مؤشرًا على وجود خطأ ما في إعدادات المشروع.

التفاعل مع المكتبة من بيئة Classic ASP

أحد الأهداف الرئيسية في استخدام RegFree COM هو القدرة على استدعاء الكائنات من بيئات مثل Classic ASP. لاستخدام المكتبة في هذا السياق، يجب أن يكون لديك المسار الصحيح إلى testComLib.dll. على سبيل المثال، يمكن استخدام الدالة GetObject كما يلي:

Set obj = GetObject("c:\...\bin\Debug\net9.0\testComLib.dll", "Class1")

إذا واجهت خطأ مثل "مكون ActiveX لا يمكنه إنشاء كائن"، فقد يكون ذلك نتيجة لعدم تحديد المكونات بشكل صحيح. في هذه الحالة، تأكد من أن كل الخطوات تمت بوضوح.

التحديات والحل

تعد مشاكل عدم الحصول على ملف manifest واحدة من أكثر المشاكل شيوعًا. الحل هنا يكمن في مراجعة إعدادات المشروع والاشتراطات الجديدة التي قد تم تقديمها في .NET 8. يجب أن تظل دائماً متابعاً لأحدث المستندات من Microsoft لمساعدتك في التكيف مع التغييرات.

في الختام، يعتبر استخدام c# – .NET 9 RegFree COM Class Library: no manifest خيارًا رائعًا للمطورين الذين يرغبون في تبسيط عملية تسجيل المكونات، مما يتيح لهم التركيز على تطوير واجهات جديدة دون مشاكل تسجيل DLL. تأكد من فهم المكونات الأساسية وأن تكون على دراية بالتعديلات اللازمة لضمان تشغيل المكتبة الخاصة بك بشكل سلس. هذه الوسيلة تسهم في نشر إصدارات جديدة بكفاءة وسرعة عالية.