samples

.NET عينات

يحتوي هذا الريبو على جميع رمز العينة الذي يعد جزءًا من أي موضوع ضمن وثائق .NET. هناك العديد من المشاريع المختلفة التي يتم تنظيمها في المرحلين الفرعيين. يتم تنظيم هذه المراكب الفرعية بشكل مشابه لتنظيم مستندات .NET. سيكون لدى بعض المقالات أكثر من عينة واحدة مرتبطة بها.

يتتبع فريق المحتوى مشكلات .NET الوثائق في مستودعات DOTNET/DOCS ومستودعات DOTNET/DOTNET-API-DOCS. يتم إيقاف القضايا على هذا المستودع. مشكلات الملفات مقابل العينات والاقتراحات الحالية للعينات الجديدة في تلك المستودعات. إذا لم تكن متأكدًا من أين ، فاختر dotnet/docs. تحافظ هذه العملية على المشكلات المرتبطة بالمقالات التي تشرح مفاهيم كل عينة. أفضل عملية تتمثل في تقديم مشكلة من التحكم في التعليقات في أسفل كل صفحة مستندات:

• بالنسبة للعينات الموجودة ، قم بتقديم المشكلة على الصفحة مع العينة.
• لاقتراح عينات جديدة ، قم بتقديم المشكلة على صفحة الفهرس حيث تريد رؤية العينة الجديدة.

يمثل الرمز في هذا المستودع البرامج التي تعرض سيناريوهات التطبيق أو المكتبة. غالبًا ما تستخدم هذه العينات أكثر من تقنية أو ميزة أو مجموعة أدوات. يحتوي كل عينة على ملف readme.md يشرح العينة وروابط الموارد لمزيد من المعلومات.

يجب أن تكون العينات مشاريع قابلة للبناء. يجب أن تبني هذه المشاريع وتشغيلها على أوسع مجموعة من المنصات الممكنة للعينة المحددة. في الممارسة العملية ، هذا يعني بناء تطبيقات وحدة التحكم الأساسية .NET حيثما كان ذلك ممكنًا. يجب أن تضيف العينات الخاصة بالويب أو إطار واجهة المستخدم تلك الأدوات حسب الحاجة. تتضمن الأمثلة تطبيقات الويب وتطبيقات الأجهزة المحمولة وتطبيقات WPF أو Windows Forms وما إلى ذلك.

نحن نعمل على وجود نظام CI في مكان لجميع التعليمات البرمجية. عندما تقوم بإجراء أي تحديثات للعينات ، تأكد من أن كل تحديث هو جزء من مشروع قابل للإنشاء. من الناحية المثالية ، أضف اختبارات للصحة على العينات أيضًا.

بناء عينة

قم ببناء أي عينة .NET Core باستخدام .NET Core CLI ، والتي يتم تثبيتها باستخدام .NET Core SDK. ثم قم بتشغيل هذه الأوامر من CLI في دليل أي عينة:

 dotnet build
dotnet run

هذه ستثبت أي تبعيات مطلوبة ، وبناء المشروع ، وتشغيل المشروع على التوالي.

عينات متعددة المشروع لها تعليمات في دليل الجذر الخاص بها في ملف README.md .

باستثناء ما هو مذكور ، تبني جميع العينات من سطر الأوامر على أي منصة مدعومة بواسطة .NET Core. هناك عدد قليل من العينات الخاصة بـ Visual Studio وتتطلب Visual Studio 2017 أو أحدث. بالإضافة إلى ذلك ، تُظهر بعض العينات ميزات خاصة بالنظام الأساسي وستتطلب منصة معينة. تتطلب العينات والمقتطفات الأخرى .NET Framework وسيتم تشغيلها على منصات Windows ، وستحتاج إلى حزمة المطورين لإصدار إطار العمل المستهدف.

إنشاء عينات جديدة

إذا كنت ترغب في إضافة عينة رمز:

1. يجب أن تكون عينة الخاص بك جزءًا من مشروع قابل للبناء . حيثما أمكن ، يجب أن تبني المشاريع على جميع المنصات التي تدعمها .NET Core. استثناءات من هذه العينات هي عينات توضح ميزة خاصة من النظام الأساسي أو أداة خاصة بالنظام الأساسي.

2. يجب أن تتوافق نموذجك مع نمط ترميز وقت التشغيل للحفاظ على الاتساق.

   • بالإضافة إلى ذلك ، نفضل استخدام الأساليب static بدلاً من أساليب مثيل عند إظهار شيء لا يتطلب إنشاء كائن جديد.

3. يجب أن تتضمن العينة معالجة الاستثناء المناسبة . يجب أن تتعامل مع جميع الاستثناءات التي من المحتمل أن يتم إلقاؤها في سياق العينة. على سبيل المثال ، يجب أن تستخدم العينة التي تستدعي طريقة Console.ReadLine لاسترداد إدخال المستخدم معالجة الاستثناءات المناسبة عند تمرير سلسلة الإدخال كوسيطة إلى طريقة. وبالمثل ، إذا كانت العينة تتوقع أن تفشل استدعاء الطريقة ، فيجب التعامل مع الاستثناء الناتج. تعامل دائمًا مع الاستثناءات المحددة التي ألقيتها الطريقة ، بدلاً من استثناءات الفئة الأساسية مثل الاستثناء أو SystemException.

4. إذا قامت نموذجك ببناء حزمة مستقلة ، فيجب عليك تضمين أوقات التشغيل التي يستخدمها نظام بناء CI الخاص بنا ، بالإضافة إلى أي أوقات تشغيل تستخدمها عينة:

   • win7-x64
   • win8-x64
   • win81-x64
   • ubuntu.16.04-x64

سيكون لدينا نظام CI في مكان لبناء هذه المشاريع قريبًا.

لإنشاء عينة:

1. قم بتقديم مشكلة أو أضف تعليقًا إلى التعليق الحالي الذي تعمل عليه.

2. اكتب الموضوع الذي يشرح المفاهيم الموضحة في عينة (مثال: docs/standard/linq/where-clause.md ).

3. اكتب نموذجك (مثال: WhereClause-sample1.cs ).

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

    public class Program
   {
       public void Main ( string [ ] args )
       {
           WhereClause1 . QuerySyntaxExample ( ) ;
   
           // Add the method syntax as an example.
           WhereClause1 . MethodSyntaxExample ( ) ;
       }
   }

5. لا تحقق في ملف الحل إذا كان يحتوي على مشروع واحد فقط.

لبناء وتشغيل العينة الخاصة بك:

1. انتقل إلى عينة المجلد وقم ببناءها للتحقق من وجود أخطاء:

    dotnet build

2. قم بتشغيل العينة:

    dotnet run

3. أضف readMe.md إلى الدليل الجذر للعينة الخاصة بك.

   يجب أن يتضمن ذلك وصفًا موجزًا ​​للرمز ، وإحالة الأشخاص إلى المقالة التي تشير إلى العينة.