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

مقالة
11/01/2010

تكوين إعدادات وقت التشغيل HTTP ASP.NET التي تحدد كيفية عملية طلب أحد تطبيقات ASP.NET.

عنصر تكوين (مخطط إعدادات عام)
النظام.ويب عنصر (مخطط إعدادات ASP.NET)
عنصر ال httpRuntime (مخطط إعدادات ASP.NET)

<httpRuntime
   executionTimeout = "number" 
   maxRequestLength = "number" 
   requestLengthDiskThreshold = "number" 
   useFullyQualifiedRedirectUrl = "[True|False]" 
   minFreeThreads = "number" 
   minLocalRequestFreeThreads = "number" 
   appRequestQueueLimit = "number"
   enableKernelOutputCache = "[True|False]" 
   enableVersionHeader = "[True|False]" 
   apartmentThreading = "[True|False]"
   requireRootedSaveAsPath = "[True|False]"
   enable = "[True|False]" 
   sendCacheControlHeader = "[True|False]" 
   shutdownTimeout = "number"
   delayNotificationTimeout = "number"
   waitChangeNotification = "number" 
   maxWaitChangeNotification = "number" 
   enableHeaderChecking = "[True|False]" 
/>

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

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

السمات

السمة	الوصف
apartmentThreading	سمة Boolean اختيارية. تمكين ترابط الأجزاء توافق ASP الكلاسيكية. هذه السمة الجديد في ‏‫NET Framework. الإصدار 2.0. يكون الإعداد الافتراضي هو False.
appRequestQueueLimit	سمة Int32 اختيارية. تعيّن الحد الأقصى لعدد طلبات قوائم الانتظار ASP.NET للتطبيق. عندما يكون هناك مؤشرات ترابط حرة كافية إلى معالجة طلب ، وضع الطلبات في قائمة الانتظار. يتم رفض الطلبات الواردة مع الخطأ "503 - جداً الخادم مشغول" عند تجاوز قائمة الانتظار الحد المحدد في هذه السمة. يكون الطول الافتراضي هو 5000. ملاحظة للحصول على إصدارات .NET Framework 1.1 و 1.0 ، الافتراضي هو 100.
delayNotificationTimeout	سمة Int32 اختيارية. يقوم بتعيين المهلة تأخير إعلامات بالثواني. هذه السمة الجديد في ‏‫NET Framework. الإصدار 2.0. الإعداد الافتراضي هو 5 ثانية.
Enable	سمة Boolean اختيارية. تحدد ما إذا تم ممكّن مجال التطبيق (AppDomain) إلى قبول الطلبات الواردة المستوى عقدة الحالي و عقدة فرعة. إذا كان Falseالتطبيق هو إيقاف. تشغيل بشكل فعال يكون الإعداد الافتراضي هو True.
enableHeaderChecking	سمة Boolean اختيارية. تحديد ما إذا كان ASP.NET يجب التحقق من عنوان الطلب عن الهجمات المحتملة الإدخال. إذا تم الكشف عن هجوم يستجيب ASP.NET مع وجود خطأ. هذه السمة جديدة في .NET Framework 2.0. يكون الإعداد الافتراضي هو True.
enableKernelOutputCache	سمة Boolean اختيارية. تحدد ما إذا تم ممكّن تخزين مؤقت. هذه السمة فقط ذات الصلة عند تثبيت Microsoft الخدمات معلومات الإنترنت (IIS) 6.0 أو أحدث. تحديد الإخراج المؤقت وتكوين طلب من نوع ما إذا كان يمكن تخزين المحتوى. إلى استجابة ذاكرة تخزين مؤقت, يجب تحقيق الخصائص التالية: يجب أن يكون بوضوح ممكّن تخزين مؤقت عن طريق توجيه الصفحة أو عن طريق استخدام واجهة برمجة تطبيقات تخزين مؤقت. يجب أن يكون تخزين مؤقت نهج انتهاء صلاحية بحيث يتعرف kernel متى يتم تجاهل الاستجابة. تخزين مؤقت ليس لدى أي رؤوس متغير أو معلمة. المصادقة غير مطلوبة. يكون الإعداد الافتراضي هو True.
enableVersionHeader	سمة Boolean اختيارية. تحديد ما إذا كان يجب إخراج ASP.NET الإصدار عنوان. يتم استخدام هذه السمة قبل Microsoft Visual Studio 2005إلى تحديد أي إصدار ASP.NET قيد الاستخدام. غير ضرورية من أجل مواقع إنتاج ولا يمكن معطّل. ملاحظة غير متوفر في هذه السمة ‏‫NET Framework 1.0.. يكون الإعداد الافتراضي هو True.
executionTimeout	سمة Int32 اختيارية. تسمح لك بتعيين الحد الأقصى لعدد الثواني المسموح طلب تنفيذه قبل الآن إيقاف تلقائيًا بواسطة ASP.NET. ينطبق هذا المهلة فقط إذا كانت السمة يصحح في compilationالعنصر False. إذا كان للمساعدة على تجنب التطبيق لأسفل إيقاف التشغيل بينما تقوم بتصحيحه لا تقم بتعيين هذا المهلة إلى القيمة قطر أيمن متوسطة.debugالسمةTrue الإعداد الافتراضي هو 110 ثانية. ملاحظة في ‏‫NET Framework 1.0. و 1.1 الافتراضي 90 ثانية.
maxRequestLength	سمة Int32 اختيارية. تعيّن الحد إدخال دفق التخزين المؤقت العتبة، بالKb. يمكن استخدام هذا الحد لمنع هجمات رفض الخدمة التي تنتج, على سبيل المثال، قبل نشر ملفات قطر أيمن متوسطة الحجم إلى الخادم المستخدمين. يكون الإعداد الافتراضي هو “,4096,” إذا تم تجاوز العتبة ConfigurationErrorsExceptionيتم طرح.
maxWaitChangeNotification	سمة Int32 اختيارية. تعيّن الحد الأقصى من رقم الثواني الواجب انتظارها من تغيير الإعلام للملف الأول قبل إعادة تشغيل AppDomain للطلب جديد. تعيين هذه السمة إلى رقم أكبر من الطول الوقت لإكمال أي عمليات نسخ الملفات. يتم دمج إعلامات تغيير الملف استناداً إلى القيمة هذه السمة و waitChangeNotificationالسمة. هذه السمة جديدة في .NET Framework 2.0. يكون الإعداد الافتراضي هو 0.
minFreeThreads	سمة Int32 اختيارية. تعيّن الحد الأدنى لرقم عمليات الجزئية الحرة للسماح بتنفيذ طلبات جديدة. يحتفظ ASP.NET المحدد رقم من عمليات جزئية الحرة للطلبات التي تتطلب عمليات جزئية إضافية إلى إتمام المعالجة. يكون الإعداد الافتراضي هو 8.
minLocalRequestFreeThreads	سمة Int32 اختيارية. تعيّن الحد الأدنى رقم عمليات جزئية الحرة التي يحتفظ ذلك ASP.NET المتوفرة بتنفيذ طلبات محلية جديدة. المحدد رقم عمليات جزئية التي تم حجز للطلبات التي تأتي من المضيف المحلي في حالة إصدار طلبات بعض طلبات الفرعة إلى المضيف المحلي أثناء المعالجة. وهذا يساعد على منع حالة توقف تام ممكنة مع طلب إعادة الإدخال عودي إلى الويب الخادم. يكون الإعداد الافتراضي هو 4.
requestLengthDiskThreshold	سمة Int32 اختيارية. تعيّن الحد إدخال دفق التخزين المؤقت العتبة، بالKb. يجب ألا يتجاوز هذه القيمة في maxRequestLengthالسمة. هذه السمة جديدة في .NET Framework 2.0. الافتراضي هو “,80,KB.
requireRootedSaveAsPath	سمة Boolean اختيارية. تحديد ما إذا كان filenameمعلمة في SaveAsيجب أن يكون الأسلوب مسار. مطلق يجب أن يكون لدى عملية ASP.NET الإذن إلى بإنشاء ملفات في الموقع المحدد. هذه السمة جديدة في .NET Framework 2.0. يكون الإعداد الافتراضي هو True.
sendCacheControlHeader	سمة Boolean اختيارية. تحديد ما إذا كان سيتم يرسل عنوان عنصر ذاكرة التخزين مؤقت الذي تم تعيين Private، عن طريق الافتراضي. إذا كان Trueتخزين مؤقت من جانب العميل هو معطل. هذه السمة جديدة في .NET Framework 2.0. يكون الإعداد الافتراضي هو True.
shutdownTimeout	سمة Int32 اختيارية. تعيّن عدد الدقائق المسموح بها للعملية المنفذّة أن يوقف التشغيل فيها. عند انتهاء صلاحية المهلة يقوم ASP.NET بإيقاف تشغيل العملية المنفِذة. هذه السمة جديدة في .NET Framework 2.0. الإعداد الافتراضي هو 90 ثانية.
useFullyQualifiedRedirectUrl	سمة Boolean اختيارية. تحديد ما إذا كان العميل إعادة التوجيه هي المؤهلة بالكامل باستخدام النموذج "https://server/path"والتي تكون مطلوبة من أجل بعض عناصر التحكم المحمول أو ما إذا كان النسبي عوامل إعادة التوجيه المرسلة إلى العميل بدلاً من ذلك. إذا كان True، يتم تلقائياً محول كافة عوامل إعادة التوجيه غير مؤهل بشكل كامل إلى النموذج مؤهل بشكل كامل. ملاحظة إذا تم تعيين هذه السمة إلى False، قد تواجه بعض برامج استعراض المشكلات عند تحميل الصفحات الموجودة في cookieless جلسات العمل. يكون الإعداد الافتراضي هو False.
waitChangeNotification	سمة Int32 اختيارية. تعيين الوقت، بالثواني، لأنتظار إعلام تغيير ملف آخر قبل إعادة التشغيل AppDomain. تعيين هذه السمة إلى رقم أكبر من وقت بين التحديثات نسخ الملفات جهازي تغيير الإعلامات. يتم دمج إعلامات تغيير الملف استناداً إلى القيمة هذه السمة و maxWaitChangeNotification السمة. هذه السمة جديدة في .NET Framework 2.0. الافتراضي هو 0 ثانية.

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

لا يوجد.

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

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

ملاحظات

httpRuntimeعنصر بتكوين إعدادات وقت التشغيل HTTP ASP.NET التي تحدد كيفية معالجة طلب أحد تطبيقات ASP.NET. يوفر برنامج .NET Framework رقم المضيفين وقت التشغيل مختلفة بما في ذلك مضيف وقت التشغيل ASP.NET. عند طلب يأتي, ASP.NET تحميل إعداد وقت التشغيل في العملية التي تتم على معالجة الطلب. يقوم ASP.NET أيضاً بإنشاء مجال تطبيق لكل تطبيق ويب يتم تشغيله على خادم ويب.

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

httpRuntimeتم تعريف عنصر غير بوضوح في الملف Machine.config أو في ملف ويب.config الجذر. ولكن، تكون الإعدادات التالية القيم الافتراضية أثناء تهيئة النظام. إذا أردت يخصص هذا المقطع يجب إنشاء ملف تكوين وتعريف السمات التي تحتاج اليخصص.

<httpRuntime 
   executionTimeout="110"
   maxRequestLength="4096"
   requestLengthDiskThreshold="80"
   useFullyQualifiedRedirectUrl="false"
   minFreeThreads="8"
   minLocalRequestFreeThreads="4"
   appRequestQueueLimit="5000"
   enableKernelOutputCache="true"
   enableVersionHeader="true"
   requireRootedSaveAsPath="true"
   enable="true"
   shutdownTimeout="90"
   delayNotificationTimeout="5"
   waitChangeNotification="0"
   maxWaitChangeNotification="0"
   requestPriority="Normal"
   enableHeaderChecking="true"
   sendCacheControlHeader="true"
   apartmentThreading="false"
/>

مثال

يوضح المثال التالي كيفية إلى تحديد معلمات وقت HTTP أحد تطبيقات ASP.NET.

<configuration>
  <system.web>
  <httpRuntime maxRequestLength="4000"
    enable = "True"
    requestLengthDiskThreshold="512
    useFullyQualifiedRedirectUrl="True"
    executionTimeout="45"
    versionHeader="1.1.4128"/>
  </system.web>
</configuration>

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

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

راجع أيضًا:

مشاركة عبر

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

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

السمات

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

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

ملاحظات

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

مثال

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

راجع أيضًا:

المهام

المرجع

المبادئ

موارد أخرى

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