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

مقالة
11/01/2010

يحتوي على مقطع التكوين و تعريفات مساحة الإسم.

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

   <configSections>
      <section />
      <sectionGroup />
      <remove />
      <clear/>
   </configSections>

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

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

السمات

لا يوجد.

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

العنصر	الوصف
clear	إزالة كافة المراجع إلى مقاطع الموروثة والمجموعات المقطع السماح المقاطع و مجموعات المقاطع التي يضيفها فقط صواب المقطع وعناصر sectionGroup .
remove	قم بإزالة مرجع إلى المقطع الموروثة والمجموعة المقطع.
section	يعرّف اقتران بين معالج مقطع تكوين و عنصر تكوين.
sectionGroup	يعرّف اقتران بين معالج مقطع تكوين عنصر تكوين.

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

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

ملاحظات

configSections تحديد عنصر التكوين صواب معالج التعريفات. هذا مطلوب لأن ASP.NET لا يقوم بأي افتراضات حول كيفية معالجة إعدادات داخل ملف التكوين. بدلاً من ذلك، يقوم ASP.NET بتفويض معالجة بيانات التكوين لمعالج مقطع التكوين.

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

إذا كان configSections صواب في ملف تكوين configSections صواب يجب أن يكون أول تابع صواب من configuration صواب.

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

مقاطع التكوين لعناصر تكوين ال.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>
      <section name="sampleSection"
               type="System.Configuration.SingleTagSectionHandler" />
   </configSections>

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

</configuration>

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

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

راجع أيضًا:

مشاركة عبر