سمات عامة موروثة من عناصر القسم

يتم تطبيق إعدادات التكوين ASP.NET إلى الموارد بطريقة هيكلية. إعدادات التكوين الموروثة من أصل ملفات التكوين. يسرد هذا الموضوع العديد من السمات العامة الموروثة بواسطة كل عناصر المقطع.

عنصر المقاطع

مقطع عناصر الأعضاء لمقاطع التكوين. هذا لا يتضمن العناصر التي هي أعضاء في مجموعات مقطع التكوين .

تظهر تعريفات مقطع التكوين في الجزء العلوي من ملف التكوين داخل العنصر configSections. كل إعلان يتضمن المقطع عنصر يحدد اسم المقطع واسم فئة .NET Framework (المشتق من ) التي تقوم بمعالجة بيانات التكوين في ذلك المقطع. المقطع يمكن تجميع علامات sectionGroup بعلامات.

لمزيد من المعلومات، راجع ملفات التكوين ASP.NET أو تحرير ملفات التكوين ASP.NET.

سمات عامة

يصف الجدول التالي سمات عامة التي يمكن تعيينها أية عناصر المقطع. هذه السمات العامة أيضاً يتم توريثها بواسطة العناصر الفرعية لعناصر المقطع. كافة السمات التي تتضمن أسماؤها العمل lock مصممة لحماية المحتوى المحدد في ملف التكوين من التغيير. لا يوجد عنصر أو سمة مؤمّنة بشكل افتراضي.

السمة

الوصف

configSource

سمة String اختيارية.

تعيّن اسم ملف التضمين حيث تم تعريف مقطع التكوين المقترنة, في حالة وجود مثل هذا ملف. للوصول برمجياً من خلال ConfigSource الخاصية.

عند استخدام configSource ذلك ، عليك نقل المقطع بالكامل في ملف منفصل بسبب عدم وجود دمج لإعدادت العنصر . أي تغيير في الملف الخارجي يؤدي التطبيق إلى إعادة التشغيل بشكل افتراضي. لتغيير هذا السلوك بحيث عدم إعادة تشغيل التطبيق بعد كل تغيير يمكنك تكوين عنصر مقطع للـ configSections (مخطط إعدادات عام) في ملف Web.config وتعيين restartOnExternalChanges السمة إلى false.

lockAllAttributesExcept

اختياري String السمة ; يمكن أن تكون القيمة بفواصل قائمة.

تأمين كل سمات العنصر الأصل ما عدا تلك المحددة.

للوصول برمجياً من خلال LockAllAttributesExcept الخاصية.

يمكن عدم قفل أدنى المستويات من هيكل تكوين المستويات التي يتم بها في أعلى الهيكل.

lockAllElementsExcept

اختياري String السمة ; يمكن أن تكون القيمة بفواصل قائمة.

تأمين كل سمات العنصر الأصل ما عدا تلك المحددة.

للوصول برمجياً من خلال LockAllElementsExcept الخاصية.

lockAttributes

اختياري String السمة ; يمكن أن تكون القيمة بفواصل قائمة.

تأمين كل السمات العنصر الأصل.

للوصول برمجياً من خلال LockAttributes الخاصية.

lockElements

اختياري String السمة ; يمكن أن تكون القيمة بفواصل قائمة.

تأمين كل العناصر الفرعية للعنصر الأصل.

للوصول برمجياً من خلال LockElements الخاصية.

lockItem

سمة String اختيارية.

true إذا كان العنصر الذي يحدث يجب أن يكون مؤمن; وإلا,false. يكون الإعداد الافتراضي هو false.

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

للوصول برمجياً من خلال LockItem الخاصية.

مثال

مثال التعليمة البرمجية التالية جزء من ملف Machine.config. إعلان معالجات مقطع التكوين لـ system.web مجموعة المقطع anonymousIdentification المجموعة. أسفل ذلك تعريف نظام وعناصر anonymousIdentification يتم تعريف عناصر التكوين.

عنصر التكوين system.Web عنصر التكوين هو عضو في تكوين مجموعة القسم ، وهذا يعني أنه لا يحتوي على أي سمات.

عنصر التكوين anonymousIdentification يكون عضو التكوين ; لذلك، فإنه يرث السمات المسرودة في الجدول السابق. لاحظ أنه configSource يحتوي على ملف خارجي معيّن إلى (أن تحتوي على محتوى العنصر) وأن lockItem يتم تعيين السمة true لمنع التغييرات على المحتوى الخاص به.

<configuration>

  <configSections>
    <!-- Other configuration sections. -->
    <sectionGroup name="system.web" ...>
      <section name="anonymousIdentification" ... />
    </sectionGroup>
  </configSections>

  <system.web>
    <anonymousIdentification  configSource="IDSourceFile.xml" 
       lockItem="true" />
  </system.web>

</configuration>

راجع أيضًا:

المهام

كيفية: تأمين إعدادات التكوين ASP.NET

المبادئ

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

وحدات سيناريو التكوين ASP.NET

تأمين تكوين ASP.NET

تحرير ملفات التكوين ASP.NET

موارد أخرى

ملفات التكوين ASP.NET