عنصر مقطع للـ configSections (مخطط إعدادات عام)

مقالة
11/01/2010

يعرّف اقتران بين معالج مقطع تكوين و عنصر تكوين.

عنصر تكوين (مخطط إعدادات عام)
  عنصر الconfigSections (مخطط إعدادات عام)
    عنصر مقطع للـ configSections (مخطط إعدادات عام)
      عنصر تكوين (مخطط إعدادات عام)
        عنصر الconfigSections (مخطط إعدادات عام)
          عنصر sectionGroup للـ configSections (مخطط إعدادات عام)
            عنصر مقطع للـ configSections (مخطط إعدادات عام)

<section 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token"
   allowDefinition= "Everywhere|MachineOnly|MachineToApplication|MachineToWebRoot" 
   allowLocation="True|False" 
   restartOnExternalChanges="True|False" 
/>

السمات والعناصر

تصف المقاطع التالية سمات، عناصر تابعة وعناصر الأصل.

السمات

السمة	الوصف
allowDefinition	سمة Enum اختيارية. ينطبق على تطبيقات ASP.NET فقط. تحديد ملف التكوين الذي يمكن استخدام المقطع فيه. يمكن أن تكون السمة إحدى القيم التالية (المعرفة في ConfigurationAllowDefinition التعداد) في ترتيب متناقص النطاق. Valueالوصف Everywhere يسمح بتكوين المقطع في أي ملف التكوين أو دليل كما يلي: Machine.config جذر Web.config. Web.config لأحد التطبيقات. الدليل الظاهري. دليل فرعي فعلي في التطبيق. إذا لم allowDefinition يتم استخدام أي سمة Everywhere يفترض.هذا هو الإعداد الافتراضي. MachineToApplication يسمح بتكوين المقطع في أحد الملفات التالية: Machine.config جذر Web.config. Web.config لأحد التطبيقات. هذا يستثني ملفات ويب.config في الدلائل الظاهرية أو دليل فرعي فعلي في التطبيق. MachineToWebRoot يسمح بتكوين المقطع في أحد الملفات التالية: Machine.config جذر Web.config. كلا ملفي .config Machine.config و جذر Web.config موجدين في %SystemRoot%\Microsoft.NET\Framework\ versionNumber \CONFIG. MachineOnly يسمح بتكوين المقطع فقط في الملف Machine.config الموجود في %SystemRoot%\Microsoft.NET\Framework\ versionNumber \CONFIG.
allowExeDefinition	سمة Enum اختيارية. ينطبق .NET Framework ugn على تطبيقات العميل فقط. تحديد ملف التكوين الذي يمكن استخدام المقطع فيه. يمكن أن تكون السمة إحدى القيم التالية (المعرفة في ConfigurationAllowExeDefinition التعداد) في ترتيب متناقص النطاق. Valueالوصف MachineToApplication يسمح بتكوين المقطع في أحد الملفات التالية: Machine.config تكوين التطبيق MachineToRoamingUser MachineToLocalUser MachineOnly يسمح بتكوين المقطع فقط في الملف Machine.config الموجود في %SystemRoot%\Microsoft.NET\Framework\ versionNumber \CONFIG.
allowLocation	سمة Boolean اختيارية. ينطبق على تطبيقات ASP.NET فقط. تحديد ما إذا كان يمكن استخدام المقطع داخل موقعالعنصر. يكون الإعداد الافتراضي هو True.
name	سمة String مطلوبة. تعيّن اسم مقطع التكوين أو العنصر المقترن بمعالج مقطع التكوين المحدد في type السمة. هذا هو اسم العنصر كما يظهر في ناحية مقطع الإعدادات في ملف التكوين.
restartOnExternalChanges	سمة Boolean اختيارية. لا ينطبق على تطبيقات ASP.NET. تحديد ما إذا كان يجب إعادة تشغيل التطبيق في حال تغيّرت بيانات التكوين للمقطع.
type	سمة String مطلوبة. تحدد اسم فئة معالج مقطع التكوين التي تعالج عملية معالجة إعدادات التكوين في المقطع أو عنصر محدد في name السمة. استخدم التنسيق التالي: type=" اسم فئة مؤهل بشكل كامل, اسم ملف التجميع, إصدار, الثقافة, رمز المفتاح العمومي" يجب أن يتطابق التعريف مع مرجع التجميع. على سبيل المثال، إذا كان رقم الإصدار في بناء جملة المثال التالي لا يطابق التجميع الذي يحدث خطأ. `type="MyConfigSectionHandler.MyHandler,MyCustomConfigurationHandler,Version=1.0.0.0,Culture=neutral,PublicKeyToken=null"` يجب أن يكون ملف التجميع موجوداً في دليل التطبيق نفسه كما في الملف Web.config الذي يعرّف ملف التجميع. في حالة جذر ملف Web.config أو الملف Machine.config يجب أن يكون ملف تجميع في الإصدار %SystemRoot%\Microsoft.NET\Framework\ .

العناصر التابعة

لا يوجد.

العناصر الأصلية

العنصر	الوصف
configuration	تحديد جذر العنصر المطلوب في كل ملف تكوين مستخدم من قبل وقت تشغيل اللغة العامة وتطبيقات NET Framework.
configSections	يحتوي على مقطع التكوين و تعريفات مساحة الإسم.
sectionGroup	يعرّف اقتران بين معالج مقطع تكوين عنصر تكوين.

ملاحظات

section يقوم العنصر بإقران معالج مقطع التكوين بعنصر تكوين أو مقطع. هذا مطلوب لأن ASP.NET لا يقوم بأي افتراضات حول كيفية معالجة إعدادات داخل ملف التكوين. بدلاً من ذلك، يقوم ASP.NET بتفويض معالجة بيانات التكوين لمعالج مقطع التكوين. كل sectionعنصر يعرف مقطع تكوين أو عنصر ثم الفئة المقترنة المشتقة من ConfigurationSection- التي تعالج مقطع التكوين أوالعنصر. section يمكن تجميع العناصر منطقياً في sectionGroup عناصر بهدف التنظيم و تجنب تعارضات التسمية. section و sectionGroup العناصر يحتوي عليها configSections العنصر.

التكوين الافتراضي

مقاطع التكوين لعناصر تكوين .NET Framework معرفه في الملف Machine.config وهي عديدة جداً لذلك يصعب سردها هنا. يقوم المقتطف التالي من الملف Machine.config بتعريف معالج مقطع التكوين لهذا authentication العنصر من system.web المقطع. ثم يتم تعريف إعدادات التكوين الخاصة authentication بالعنصر.

إذا لم يكن معالج مقطع تكوين مقترنا بعنصر تكوين يقوم ASP.NET بإصدار هذا الخطأ في الخادم,"مقطع تكوين غير معروف" اسم العنصر ."

<configuration>
    <configSections>
        <sectionGroup name="system.web" type="System.Web.Configuration.SystemWebSectionGroup, System.Web, Version=%ASSEMBLY_VERSION%, Culture=neutral, PublicKeyToken=%MICROSOFT_PUBLICKEY%">
            <section name="authentication" type="System.Web.Configuration.AuthenticationSection, System.Web, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" allowDefinition="MachineToApplication" />
            <!-- Other system.web sections -->
        </sectionGroup>
        <!-- Other configuration sections -->
    </configSections>

    <system.web>
        <authentication mode="Windows">
            <forms name=".ASPXAUTH" 
                   loginUrl="login.aspx" defaultUrl="default.aspx" 
                   protection="All" 
                   timeout="30" 
                   path="/" 
                   requireSSL="False" 
                   slidingExpiration="True" 
                   cookieless="UseCookies" 
                   domain="" 
                   enableCrossAppRedirects="False">
                <credentials passwordFormat="SHA1" />
            </forms>
            <passport redirectUrl="internal" />
        </authentication>
        <!-- Other system.web elements -->
    </system.web>
    <!-- Other configuration settings -->
</configuration>

مثال

يُظهر مثال التعليمات البرمجية التالي كيفية تحديد مقطع تكوين مخصص و تحديد إعدادات ذلك المقطع.

<configuration>

   <configSections>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

   <sampleSection setting1="Value1" 
                  setting2="value two" 
                  setting3="third value" />

</configuration>

معلومات العنصر

معالج مقطع التكوين	لا تنطبق
عضو التكوين	ConfigurationSection
مواقع للتكوين	Machine.config مستوى جذر ويب.config مستوى تطبيق ويب.config الدليل–المستوى ويب.config الفعلية أو الظاهرية
المتطلبات	قم بإعادة تشغيل Microsoft Internet Information Services (IIS) 5.0. .NET Framework، الإصدار 1.0 أو 1.1 أو 2.0 Microsoft Visual Studio 2003 أو Visual Studio 2005

راجع أيضًا:

مشاركة عبر