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

مقالة
11/01/2010

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

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

<sectionGroup 
   name="section name"
   type="configuration section handler class, assembly file name, version, culture, public key token">
   <section />
/>

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

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

السمات

السمة	الوصف
name	سمة String مطلوبة. يعيّن اسم مقطع التكوين أو العنصر المقترن بمعالج مقطع التكوين المحدد بواسطة السمة type . هذا هو اسم العنصر كما يظهر في منطقة مقطع الإعدادات في ملف التكوين.
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\ .

السمة

الوصف

name

سمة String مطلوبة.

يعيّن اسم مقطع التكوين أو العنصر المقترن بمعالج مقطع التكوين المحدد بواسطة السمة type . هذا هو اسم العنصر كما يظهر في منطقة مقطع الإعدادات في ملف التكوين.

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\ .

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

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

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

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

ملاحظات

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

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

مقاطع التكوين لعناصر تكوين ال.NET يتم تعريفها في ملف 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>
      <sectionGroup name="mySectionGroup">
         <section name="mySection"
            type="System.Configuration.NameValueSectionHandler" />
      </sectionGroup>
   </configSections>
   <mySectionGroup>
      <mySection>
         <add key="key1" value="value1" />
      </mySection>
   </mySectionGroup>
</configuration>

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

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

راجع أيضًا:

مشاركة عبر