تصنيف عنصر (مخطط إعدادات ASP.NET)

مقالة
11/01/2010

تكوين إعدادات يحول برمجياً لالكل يستخدم ASP.NET إلى ترجمة التطبيقات.

<configuration>العنصر
النظام.ويب عنصر (مخطط إعدادات ASP.NET)
تصنيف عنصر (مخطط إعدادات ASP.NET)

<compilation 
   debug="[true|false]"
   batch="[true|false]"
   batchTimeout="number of seconds"
   defaultLanguage="language" 
   explicit="[true|false]" 
   maxBatchSize="maximim number of pages"
   maxBatchGeneratedFileSize="maximum combined size"
   numRecompilesBeforeAppRestart="number"
   strict="[true|false]" 
   tempDirectory="temporary files directory"
   urlLinePragmas="[true|false]"
   optimizeCompilations="[true|false]"
   targetFramework="2.0|3.0|3.5|4.0"
   assemblyPostProcessorType="assembly post processor, assembly"
>
   <assemblies>...</assemblies> 
   <buildProviders>...</buildProviders>
   <folderLevelBuildProviders>...</folderLevelBuildProviders>
   <codeSubDirectories>...</codeSubDirectories>
   <compilers>...</compilers>
   <expressionBuilders>...</expressionBuilders>
</compilation>

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

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

السمات

السمة	الوصف
assemblyPostProcessorType	سمة String اختيارية. تعيّن خطوة التحويل برمجي ينشر-process الخاصة بالتجميع حسب الإشارة إلى ينشر-processor تجميع. استخدم تنسيق "التجميع ينشر المعالج ,التجميع". التجميع صواب المعالج يجب أن تقوم بتنفيذ IAssemblyPostProcessor واجهة. باستخدام هذا الأسلوب من ينشر-processing يفرض يصحح على التصنيف الذي يمكنك يمنع عند تحديد الوضع توزيع. هذه السمة الجديد في ‏‫NET Framework. الإصدار 2.0. الافتراضي عبارة عن سلسلة فارغة.
batch	سمة Boolean اختيارية. الإشارة إلى ما إذا كان يتم اعتماد تجميع. إذا True ، يحل تأخير سبب التصنيف المطلوبة عند الوصول صواب الوقت الأول. عند ترتيب هو السمة هو معينة إلى True، precompiles ASP.NET الجميع التحويل البرمجي للملفات uncompiled في الوضع دفعي، والذي يجعل فترة تأخير الأولى أطول من الملفات. ولكن, بعد هذا التأخير المبدئي, تأخير التحويل البرمجي يزول بعد الوصول المتتالي للملف. يكون الإعداد الافتراضي هو True.
batchTimeout	سمة TimeSpan اختيارية. تعيّن فترة المهلة بالثواني لتصنيف الدفعي. إذا كان التحويل البرمجي إتمام ضمن فترة المهلة المحول البرمجي وعكسه إلى الوضع التحويل البرمجي واحد للالصفحة الحالية. الافتراضي هو 100 استعلام.
debug	سمة Boolean اختيارية. تحديد ما إذا كنت تريد يحول برمجياً debug الثنائيات بدلاً من الثنائيات البيع بالتجزئة. يكون الإعداد الافتراضي هو False.
defaultLanguage	سمة String اختيارية. تحديد لغة مثل البرمجة الافتراضية "C#" أو "PERL" صواب استخدام في ملفات التحويل البرمجي الحيوية. يتم تعريف أسماء اللغة باستخدام إما compilers العنصر system.codeDom صواب أو عنصر تابع compilers من هذا العنصر (إهمال). يكون الإعداد الافتراضي هو "vb".
explicit	سمة Boolean اختيارية. تحديد ما إذا كان صواب تعيين في Microsoft Visual Basic explicit ترجمة الخيار. إذا كان True ، يجب تعريف كافة متغيرات باستخدام Dim ، Private ، Public, أو ReDim العبارة. يكون الإعداد الافتراضي هو True.
maxBatchGeneratedFileSize	سمة Int32 اختيارية. تعيّن المدمجة الحجم الأقصى (بالكيلوبايت) ملفات مصدر التي تم إنشاؤها لكل التحويل البرمجي الدفعي. بشكل عام، ليست مثالي إلى تحميل تجميع كبير جداً في الذاكرة عند الحاجة فعلياً بتات أقل. يساعد هذا الحد للتأكد من الحجم التجميعات تقع ضمن نطاق معقولة بحيث التطبيق الاستفادة من تقنية الدفعي بدون الزائد النظام. تشبه هذه صواب maxBatchSize. يكون الإعداد الافتراضي هو 1000.
maxBatchSize	سمة Int32 اختيارية. تعيّن الحد الأقصى لعدد الصفحات لكل التحويل البرمجي الدفعي. يكون الإعداد الافتراضي هو 1000.
numRecompilesBeforeAppRestart	سمة Int32 اختيارية. تحديد رقم recompiles ديناميكي من الموارد التي يمكن أن تحدث قبل إعادة تشغيل التطبيق. يتم اعتماد هذه السمة على المستوى التطبيق و العمومي ولكن وليس على المستوى الدليل. ملاحظة زيادة ASP.NET NumRecompilesBeforeAppRestart الخاصية في كل مرة يتم إبطالها تجميع ويفشل صواب يمكن حذف. يكون الإعداد الافتراضي هو 15.
optimizeCompilations	سمة Boolean اختيارية. تحديد إعادة ما إذا كان التحويل البرمجي ديناميكي سيتم ترجمة موقع بأكمله إذا تم تم تغييره ملف المستوى أعلى. المستوى الأعلى تتضمن ملفات الملف عمومي.asax الكل الملفات في مجلدات سلة و App_Code. إذا كان True فقط تغيير صواب يتم recompiled. يكون الإعداد الافتراضي هو False. لمزيد من المعلومات، راجع فهم التحويل البرمجي الحيوية ASP.NET.
strict	سمة Boolean اختيارية. تحديد ما إذا كان صواب تمكين في Visual Basic strict ترجمة الخيار. يكون الإعداد الافتراضي هو False.
targetFramework	سمة String اختيارية. تحديد إصدار .NET Framework التي أهداف موقع ويب. يكون الإعداد الافتراضي هو Null. إذا تم حذف هذه السمة الإصدار الهدف يتحدد بواسطة الإعدادات الأخرى في ملف Web.config وبواسطة تجمّع تطبيقات IIS من موقع ويب مقترن مع. للمزيد من المعلومات، راجع CompilationSection.TargetFramework وإطار عمل .NET استهداف لمشاريع ويب.
tempDirectory	سمة String اختيارية. تعيّن الدليل المستخدمة لتخزين الملفات المؤقتة أثناء التحويل البرمجي. الافتراضي عبارة عن سلسلة فارغة. في حالة التي سلسلة فارغة إذا توفرت العملية الحالية أذونات وصول المطلوبة يتم تخزين الملفات في %FrameworkInstallLocation%\ الدليل المؤقت ملفات ASP.NET. لاحظ أنه يمكن الوصول العمليات فقط بأذونات عالية من الثقة في %FrameworkInstallLocation%\ ملفات ASP.NET المؤقتة.
urlLinePragmas	سمة Boolean اختيارية. تعيّن ما إذا كان المحول البرمجي يجب استخدام محددات مواقع المعلومات (URL) بدلاً من المسارات الفعلية. يكون الإعداد الافتراضي هو False.

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

العنصر	الوصف
assemblies	يعرّف مجموعة أسماء التجميعات التي يتم استخدامها أثناء التحويل البرمجي لمورد ASP.NET.
buildProviders	تعريف مجموعة من موفري البنية المستخدمة في تجميع مخصص ملفات الموارد. لمزيد من المعلومات، راجع فئة BuildProvider.
codeSubDirectories	يعرّف مجموعة مرتبة من الدلائل الفرعية التي تحتوي على ملفات التحويل البرمجي في وقت التشغيل.
compilers	تعريف مجموعة من الخيارات برنامج التحويل البرمجي. ملاحظة تم إهمال هذا العنصر في .NET Framework الإصدار 2.0 والإصدارات الأحدث، لصالح من العنصر compilers المقطع system.codeDom.compilersومع ذلك، باستخدام compilationعنصر فرع من compilersالعنصر ما زال صالحاً ثم يتجاوز system.codedomالعنصر الموجود في المقطع.
expressionBuilders	Defines a collection of resource strings to be used during compilation. سلاسل المورد إقران البادئات النظم التعبير.
folderLevelBuildProviders	تعريف مجموعة من موفري البنية المستخدمة في ترجمة الموارد المخصصة الملفات في مجلدات معينة. بنية تعيين إلى ملحقات أسماء الملفات وموفري المستخدمة لبنية تعليمات برمجية من النوع المحدد من الملفات. لمزيد من المعلومات، راجع فئة FolderLevelBuildProvider.

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

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

ملاحظات

compilation عنصر تكوين كافة إعدادات التحويل البرمجي يستخدم ASP.NET صواب تجميع تطبيقات.

تم إهمال هذا العنصر في .NET Framework الإصدار 2.0 والإصدارات الأحدث، لصالح من العنصر compilers المقطع compilation compilers المقطع system.codeDom . compilersومع ذلك، باستخدام compilationعنصر فرع من compilersالعنصر ما زال صالحاً ثم يتجاوز system.codedomالعنصر الموجود في المقطع.

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

The following default compilation element is not explicitly configured in the Machine.config file or in the root Web.config file. ومع ذلك، هو التكوين التي يتم إرجاعها من قبل التطبيق. إضافة عناصر صواب التجميعات و buildProviders و مجموعات expressionBuilders من ملف Web.config الجذر.

<compilation 
   tempDirectory="" 
   debug="false" 
   strict="false" 
   explicit="true" 
   batch="true" 
   batchTimeout="900" 
   maxBatchSize="1000" 
   maxBatchGeneratedFileSize="1000" 
   numRecompilesBeforeAppRestart="15" 
   defaultLanguage="vb" 
   urlLinePragmas="false" 
   assemblyPostProcessorType=""
>
   <assemblies>
       <clear />
   </assemblies>
   <buildProviders>
       <clear />
   </buildProviders>
   <expressionBuilders>
       <clear />
   </expressionBuilders>
</compilation>

تم تكوين عنصر التحويل البرمجي الافتراضية التالية في الملف Machine.config في .NET Framework الإصدار 1.1. إعدادات مشابهة موجودة في .NET Framework إصدار 1.0 ، مع استثناء أرقام الإصدارات.

<compilation debug="false" explicit="true" defaultLanguage="vb">
   <compilers>
      <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CSharp.CSharpCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" warningLevel="1"/>
      <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.VisualBasic.VBCodeProvider, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <compiler language="js;jscript;javascript" extension=".js" type="Microsoft.JScript.JScriptCodeProvider, Microsoft.JScript, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <compiler language="VJ#;VJS;VJSharp" extension=".jsl" type="Microsoft.VJSharp.VJSharpCodeProvider, VJSharpCodeProvider, Version=7.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/></compilers>
   <assemblies>
      <add assembly="mscorlib"/>
      <add assembly="System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Web, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Data, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Web.Services, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Xml, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
      <add assembly="System.Drawing, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.EnterpriseServices, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="System.Web.Mobile, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"/>
      <add assembly="*"/>
   </assemblies>
</compilation>

مثال

يوضح مثال التعليمة البرمجية التالية كيف إلى تكوين إعدادات التحويل البرمجي للتطبيق.

<configuration>
   <system.web>
      <compilation defaultLanguage="VB"
         targetFramework="4.0"
         debug="true"
         numRecompilesBeforeAppRestart="15">
         <assemblies>
            <add assembly="ADODB"/>
            <add assembly="*"/>
         </assemblies>

         <codeSubDirectories>
           <add directoryName="mySubDir1"/>
           <add directoryName="mySubDir2"/>
           <add directoryName="mySubDir3"/>
         </codeSubDirectories>

         <buildProviders>
            <buildProvider 
               extension=".mafx" type="BuildProviderType, 
                          BuildProviderAssembly"
            />
        </buildProviders>
     </compilation>
   </system.web>
</configuration>

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

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

راجع أيضًا:

مشاركة عبر

تصنيف عنصر (مخطط إعدادات ASP.NET)

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

السمات

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

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

ملاحظات

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

مثال

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

راجع أيضًا:

المهام

المرجع

المبادئ

موارد أخرى

الموارد الإضافية