معلومات: نظرة عامة حول تكوين ASP.NET

تشير هذه المقالة إلى مساحة الاسم Microsoft.NET Framework مكتبة الفئة التالية:

  • System.Configuration

ملخص

توفر هذه المقالة مقدمة إلى إطار عمل صفحة ASP.NET.

لنظرات عامة حول ASP.NET إضافية، راجع مقالة "قاعدة معارف Microsoft" التالية:
معلومات 305140 : خارطة الطريق ASP.NET

مزيد من المعلومات

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

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

التكوين: ما هو الجديد

على النقيض من إعدادات تطبيق صفحات الملقم النشطة (ASP) التي يتم تخزينها في قاعدة التعريف خدمات معلومات إنترنت ل Microsoft (IIS)، يتم تخزين إعدادات التكوين ASP.NET في ملفات لغة التوصيف الموسعة (XML). يوفر الميزات التالية عند الرغبة في تغيير إعدادات تكوين ونشر التطبيقات:
  • يتم تخزين ملفات التكوين ASP.NET في نفس الدليل كمحتوى الموقع. عند النشر، تحتاج فقط إلى نسخ الدليل المحتوى للحصول على كل من المحتوى وتكوين التطبيق.
  • يمكنك استخدام برامج تحرير النص القياسي لتعديل ملفات التكوين. وهذا يجعل من السهل تغيير إعدادات تكوين كلا محلياً وعن بعد.
  • تكون ملفات التكوين الموسعة؛ وكنتيجة لذلك، يمكنك إضافة إعدادات التكوين المخصصة الخاصة بك.
  • النظام تلقائياً بالكشف عن التغييرات في ملفات تكوين ASP.NET. ليس لديك لإعادة تشغيل IIS أو إعادة تشغيل ملقم ويب لتصبح الإعدادات نافذة المفعول.

تنسيق الملف وهيكل التكوين

هناك نوعان من ملفات التكوين التي يجب أن تكون قلقا لتطبيقات ASP.NET: Machine.config و Web.config. كلا الملفين يستند إلى XML وتحتوي على مقاطع التكوين مشابهة. ومع ذلك، يتضمن الملف Machine.config معلومات التكوين حول كافة تطبيقات.NET لإصدار محدد من الإطار، بينما تتضمن ملفات Web.config إعدادات التكوين أكثر تفصيلاً حول تطبيقات ASP.NET محددة. النص الموجود في Machine.config و Web.config حساس لحالة الأحرف.

لمزيد من المعلومات حول التنسيق ملفات تكوين ASP.NET، راجع الموضوع التالي في وثائق.NET Framework برامج تطوير مجموعة (SDK):عندما يتم طلب صفحة.aspx، يتم تجميع ملفات التكوين بطريقة يمكن أن يتجاوز إعداد تكوين في ملف Web.config المخزنة في دليل فرعي إعداد في ملف Web.config في دليل تطبيق، التي تتجاوز إعدادات على مستوى موقع ويب وإعدادات في ملف Machine.config. بعد أن يتم التحويل البرمجي لإعدادات التكوين، سيتم تخزينها مؤقتاً للطلبات المستقبلية حتى يتم تعديل أحد ملفات التكوين.

يسرد الجدول التالي مواقع ملفات تكوين نموذج لعنوان URL http://myserver/myapplication/mydir/mypage.aspx:

مستوىمسار
إعدادات التكوين لهذا الإصدار من برنامج.NET FrameworkWinnt\Microsoft.net\Framework\v.version\Config\Machine.config
إعدادات موقع ويبInetpub\Wwwroot\Web.config
إعدادات التطبيقInetpub\Wwwroot\Myapplication\Web.config
إعدادات دليل فرعيInetpub\Wwwroot\Myapplication\Mydir\Web.config

اختياري ملف Web.config على أي مستوى، لكن مطلوب ملف Machine.config.

لمزيد من المعلومات حول التسلسل الهرمي للتكوين، راجع الموضوع التالي في وثائق SDK إطار عمل.NET:لتطبيق إعدادات التكوين إلى الموارد المحددة، استخدم علامة < الموقع > مع سمة المناسبة. يمكنك استخدام سمة المسار لتحديد ملف أو فرع دليل معين التي تنطبق إعدادات التكوين الفريدة من نوعها.

لمزيد من المعلومات حول العلامة < الموقع > الرجوع إلى الموضوع التالي في وثائق.NET Framework SDK:
إعدادات التكوين < الموقع >
http://msdn.microsoft.com/en-us/library/6hbkh9s7(v=vs.71).aspx

مقطع تكوين ASP.NET

وترد في القسم < system. web > ، الذي يرد في العلامة < تكوين > مقطع تكوين ASP.NET:
   <configuration>      <appSettings></appSettings>
<system.web>
...
<webServices></webServices>
</system.web>
</configuration>

يسرد الجدول التالي كافة مقاطع التكوين ASP.NET:

المقطعالوصف
تكوين إعدادات مخصصة لأحد تطبيقات. ويمكن مقارنة الإعدادات الموجودة في هذا المقطع لمتغيرات التطبيق.
تكوين وضع المصادقة لتحديد نوع المصادقة الذي سيتم استخدامه.
تكوين التخويل الدعم والتحكم في وصول العميل إلى موارد URL.
تكوين إعدادات مكون قدرات المستعرض.
تكوين كافة إعدادات التحويل البرمجي يستخدم ASP.NET.
يوفر معلومات حول رسائل الخطأ المخصصة لتطبيق ASP.NET.
تكوين إعدادات عولمة للتطبيق.
يعين الطلبات الواردة في عنوان URL إلى الفئات IHttpHandler .
يضيف أو يزيل أو يمسح HTTP النمطية داخل أحد تطبيقات.
تكوين إعدادات وقت التشغيل ASP.NET HTTP.
يتحكم هوية التطبيق تطبيق ويب.
تكوين المفاتيح لاستخدامها لتشفير وفك تشفير بيانات ملف تعريف ارتباط مصادقة النماذج. يمكنك هذا المقطع تكوين مفتاح التحقق من صحة التي تنفذ عمليات فحص مصادقة الرسالة على بيانات عرض الحالة وتذاكر مصادقة النماذج.
تعريف إعدادات التكوين الخاصة بالصفحة.
تكوين إعدادات طراز معالجة ASP.NET على أنظمة ملقم ويب IIS. لاحظ أنه يمكنك فقط استخدام هذه العلامة في الملف Machine.config.
يعرف تعيينات صالح من مستويات الأمان المسماة إلى ملفات سياسة.
تكوين حالة جلسة عمل الوحدة النمطية.
تكوين خدمة التتبع ASP.NET.
تكوين مجموعة أذونات أمان الوصول إلى التعليمات البرمجية المستخدمة لتشغيل تطبيق معين.
التحكم في إعدادات خدمات ويب ASP.NET.

يتم الآن استرداد معلومات التكوين

يمكنك استرداد المعلومات المخزنة في ملف التكوين، ولكن تختلف الأساليب لإعدادات تكوين مختلفة. تعرض بعض الإعدادات كخصائص الكائنات المضمنة، والإعدادات الأخرى غير قابلة للوصول لأن هذه الإعدادات الداخلية إلى ASP.NET.

على سبيل المثال، يمكنك استخدام التعليمات البرمجية التالية للوصول إلى إعدادات < browserCaps > من خلال كائن Request.Browser :

Microsoft Visual Basic.NET
Response.Write(Request.Browser.VBScript.ToString())
Microsoft Visual C#.NET
Response.Write(Request.Browser.VBScript.ToString());
لمزيد من المعلومات حول كيفية استرداد إعدادات التكوين، راجع الموضوع التالي في وثائق.NET Framework SDK:
الوصول إلى إعدادات التكوين
http://msdn.microsoft.com/en-us/library/4c2kcht0.aspx

توسيع مقطع التكوين

وظيفة تكوين.NET Framework الكامل قابلة للتمديد. هناك طريقتان يمكنك فيه توسيع تكوين:
  • إنشاء معالج مقطع تكوين مخصص.

    للحصول على معلومات إضافية حول كيفية إنشاء معالجات مقطع التكوين ASP.NET مخصصة، انقر فوق رقم المقالة التالي لعرضها في "قاعدة المعارف ل Microsoft":
    309045 كيفية: إنشاء معالج مقطع تكوين ASP.NET مخصصة في Visual C#.NET
  • استخدم المقطع < appSettings > لتخزين بيانات التطبيق معينة. للحصول على معلومات حول بناء جملة قسم < appSettings > الرجوع إلى الموضوع التالي في وثائق.NET Framework SDK:لاسترداد قيم من قسم < appSettings > ، استخدم التعليمات البرمجية التالية في ملف.config:
            <appSettings><add key="MySetting" value="Valuable Information" />
    </appSettings>

    ثم استخدم التعليمات البرمجية التالية لاسترداد القيمة:

    ملاحظة: يجب أن يتضمن مساحة الاسم System.Configuration للوصول إلى appSettings.

    Visual Basic.NET
        Label1.Text = ConfigurationSettings.AppSettings.Item("MySetting")
    Visual C#.NET
        Label1.Text = ConfigurationSettings.AppSettings["MySetting"];
خصائص

رقم الموضوع: 307626 - آخر مراجعة: 18‏/01‏/2017 - المراجعة: 1

تعليقات