مشاركة عبر

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

  • مقالة

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

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

<pages     
   asyncTimeout="number"
   autoEventWireup="[True|False]"
   buffer="[True|False]"
   clientIDMode="[AutoID|Predictable|Static]"
   compilationMode="[Always|Auto|Never]" 
   controlRenderingCompatibilityVersion="[3.5|4.0]"
   enableEventValidation="[True|False]"
   enableSessionState="[True|False|ReadOnly]"
   enableViewState="[True|False]"
   enableViewStateMac="[True|False]"
   maintainScrollPositionOnPostBack="[True|False]" 
   masterPageFile="file path" 
   maxPageStateFieldLength="number" 
   pageBaseType="typename, assembly"
   pageParserFilterType="string" 
   smartNavigation="[True|False]"
   styleSheetTheme="string"
   theme="string"
   userControlBaseType="typename"
   validateRequest="[True|False]"
   viewStateEncryptionMode="[Always|Auto|Never]" 
>
   <controls>...</controls>
   <namespaces>...</namespaces>
   <tagMapping>...</tagMapping>
   <ignoreDeviceFilters>...</ignoreDeviceFilters>
</pages>

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

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

السمات

السمة

الوصف

asyncTimeout

سمة TimeSpan اختيارية.

تعيّن عدد ثواني الانتظار لمعالج غير متزامن للإكمال أثناء معالجة غير متزامنة.

هذه السمة الجديد في ‏‫NET Framework. الإصدار 2.0.

الافتراضي هو"0:00:45" (54ثواني).

autoEventWireup

سمة Boolean اختيارية.

تحديد ما إذا تم تمكين أحداث الصفحة تلقائياً. هذا إذا كان ربط الحدث يحدث تلقائيا، مما يعني أن النظام سوف يرفق تلقائياً أساليب توقيع محددة ( Page_Loadمثلاً). لمزيد من المعلومات، راجع طراز أحداث التحكم Server ASP.NET على ويب.

يكون الإعداد الافتراضي هو True.

buffer

سمة Boolean اختيارية.

تعيين ما إذا كان استخدام مورد محدد موقع المعلومات (URL) يستخدم استجابة التخزين المؤقت.

يكون الإعداد الافتراضي هو True.

clientIDMode

يحدد الخوارزمية التي سوف تستخدم لإنشاء ClientIDقيم عناصر التحكم. القيمة الافتراضية هي AutoID. القيمة الافتراضية لعناصر التحكم هي Inherit ولذلك، يتم تحديد الخوارزمية الافتراضية لعناصر التحكم في الصفحة بواسطة ClientIDModeإعداد الصفحة. يمكن تعيين قيمة افتراضية مختلفة في الصفحة @ توجيه الصفحة أو في التحكم @ التوجيه لعنصر تحكم المستخدم. للحصول على معلومات أكثر حول الخوارزميات راجعClientIDModeو معرف عنصر تحكم ASP.NET.

compilationMode

سمة CompilationMode اختيارية.

تحديد ما إذا كان صفحة ASP.NET أو عنصر التحكم يجب أن يكون مجمع في وقت التشغيل.

compilationMode السمة جديدة في ‏‫NET Framework. الإصدار 2.0. يمكن أن تكون هذه السمة إحدى القيم الممكنة التالية. يكون الإعداد الافتراضي هو Always.

Valueالوصف
Always يجب أن يتم تحويل الصفحة برمجيا دوماً.
Auto ASP.NET لن يقوم بترجمة الصفحة، إذا كان ذلك ممكناً.
Never لا ينبغي أبدا تصنيف الصفحة أو عنصر تحكم بشكل حيوي. إذا كانت صفحة تحتوي على حظر برنامج نصي أو بناء تعليمات برمجية تتطلب التحويل البرمجي, سيتم استرجاع ASP.NET مع وجود خطأ و لن يتم تشغيل الصفحة.

controlRenderingCompatibilityVersion

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

ملاحظةملاحظة
controlRenderingCompatibilityVersion جديد في ASP.NET 4.تعيينها لرقم الإصدار الحالي له نفس التأثير عند عدم تعيين ذلك الإعداد.وفي كلتا الحالتين، العناصر تقدم HTML كما تم تصميمها للإصدار الحالي.الإصدار الأقدم الذي يمكن تعيين هذه السمة إليه هو 3.5.

لمزيد من المعلومات، راجع PagesSection.ControlRenderingCompatibilityVersionو Control.RenderingCompatibilityالخصائص.

enableEventValidation

تحديد ما إذا كانت الصفحات وعناصر التحكم تتحقق من صحة أحداث إعادة النشر و رد الاتصال. يكون الإعداد الافتراضي هو True.

enableSessionState

سمة String اختيارية.

تعيّن حالة متطلبات جلسة العمل للموارد الموجودة في نطاق ملف التكوين.

enableSessionState يمكن أن تكون هذه السمة إحدى القيم الممكنة التالية. يكون الإعداد الافتراضي هو True.

Valueالوصف
False يشير إلى أن حالة جلسة العمل معطلة.
ReadOnly يشير إلى أن حالة جلسة العمل غير قابل للكتابة.
True يشير إلى أن حالة جلسة العمل معطلة.

enableViewState

سمة Boolean اختيارية.

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

يكون الإعداد الافتراضي هو True.

enableViewStateMac

سمة Boolean اختيارية.

تحديد ما إذا كان يجب على ASP.NET تشغيل رسالة رمز المصادقة (MAC) على عرض الحالة للصفحة عندما يتم نشر الصفحة مرة أخرى من العميل. إذا كان True، عرض الحالة المشفر مدقق للتأكد من أنه لم يتم العبث فيه على العميل.

يكون الإعداد الافتراضي هو True.

maintainScrollPositionOnPostBack

سمة Boolean اختيارية.

تحديد ما إذا كان سيتم إرجاع المستخدم إلى نفس الموقع في مستعرض العميل عندما يتم نشر الصفحات مرة أخرى إلى الخادم. إذا كان False، يتم إرجاع المستخدم إلى أعلى الصفحة في إعادة النشر.

هذه السمة جديدة في .NET Framework 2.0.

يكون الإعداد الافتراضي هو False.

masterPageFile

سمة String اختيارية.

تعيين مسار الصفحة رئيسي بالنسبة لملف التكوين المحلي. الصفحات التي تم masterPageFileتعيين السمة لـTrueيجب أن تحتوي على Contentعنصر تحكم كعنصر التحكم ذو المستوى الأعلى

هذه السمة جديدة في .NET Framework 2.0.

الافتراضي عبارة عن سلسلة فارغة.

maxPageStateFieldLength

سمة Int32 اختيارية.

تعيّن الحد الأقصى للطول بالأحرف لحقل الحالة في الصفحة. عند تعيين رقم موجب يتم فصل حقل حالة العرض التي يتم إرسالها إلى مستعرض العميل إلى قطع كل قطعة أقل من الحجم المحدد في maxPageStateFieldLengthالسمة. عند تحديد رقم موجب، يجب عدم فصل حالة العرض لقطع.

هذه السمة جديدة في .NET Framework 2.0.

يكون الإعداد الافتراضي هو "-1".

pageBaseType

سمة String اختيارية.

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

الافتراضي هو "System.Web.UI.Page.

pageParserFilterType

سمة String اختيارية.

تعيّن اسم نوع عامل التصفية المستخدم بواسطة محلل ASP.NET لتحديد ما إذا كان مسموحاً لعنصر في الصفحة في وقت التوزيع. يجب اشتقاق عامل تصفية من PageParserFilterالفئة.

هذه السمة جديدة في .NET Framework 2.0.

الافتراضي عبارة عن سلسلة فارغة.

smartNavigation

سمة Boolean اختيارية.

تحدد ما إذا تم تمكين التنقل ذكى. يتطلب التنقل ذكى مايكروسوفت إنرنت إكسبلورر الإصدار 5.5 أو الإصدارات الأحدث. عند تمكين التنقل ذكى يواجه المستخدم الفوائد التالية:

  • يتم إزالة وميض التنقل.

  • يتم استمرار موضع التمرير بين الصفحات.

  • تركيز العنصر يستمر بين الصفحات.

  • الحالة الأخيرة للصفحة هي الحالة الوحيدة اللتي يتم الاحتفاظ بها بواسطة المحفوظات في المستعرض.

هذه السمة جديدة في ‏‫NET Framework 2.0. ولكن تم إهمالها لصالح maintainScrollPositionOnPostBackالسمة.

يكون الإعداد الافتراضي هو False.

styleSheetTheme

سمة String اختيارية.

تعيّن اسم المجلد "نسق مسمى" لكي يتم استخدامه في تطبيق النسق قبل تعريفات التحكم وبالمقابل مع سمة النسق التي تعرّف النسق لكي يطبق بعد تعريف عنصر تحكم.

هذه السمة جديدة في .NET Framework 2.0.

الافتراضي عبارة عن سلسلة فارغة.

theme

سمة String اختيارية.

تعيين اسم النسق المستخدم للصفحات الموجودة في نطاق ملف التكوين. يجب أن يكون النسق المحدد موجود كأحد التطبيقات أو النسق العام. إذا كان النسق غير موجود، HttpExceptionيتم طرح الاستثناء.

هذه السمة جديدة في .NET Framework 2.0.

الافتراضي عبارة عن سلسلة فارغة.

userControlBaseType

سمة String اختيارية.

تعيين الأساس الذي يجب استخدامه عندما تكون الصفحات مستقلة فقط.

يكون الإعداد الافتراضي هو "System.Web.UI.UserControl".

validateRequest

سمة Boolean اختيارية.

يشير إلى أن ASP.NET يفحص كافة الإدخالات من المستعرض لاستكشاف أي بيانات خطرة. إذا كان True، يتم إجراء طلب إجراء التحقق من الصحة بمقارنة كافة بيانات الإدخال بقائمة بالقيم خطرة. إذا حدث تطابق يقوم ASP.NET برفع على HttpRequestValidationException‏‏ استثناء.

يكون الإعداد الافتراضي هو True.

viewStateEncryptionMode

سمة ViewStateEncryptionMode اختيارية.

تحديد وضع التشفير لعرض الحالة. ViewStateEncryptionModeتتجاوز الخاصية هذه السمة و التي تم تعيينها في ملف التكوين.

يمكن أن تكون هذه السمة إحدى القيم الممكنة التالية.

Valueالوصف
Always يتم تشفير حالة العرض دائماً.
Auto يتم تشفير حالة العرض، إذا طلبه عنصر تحكم.
Never لا يتم أبداً تشفيرحالة العرض حتى إذا قام عنصر تحكم بطلبه.

هذه السمة جديدة في .NET Framework 2.0.

يكون الإعداد الافتراضي هو Auto.

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

العنصر

الوصف

controls

يعرف مجموعة من موجهات التسجيل و مساحات الأسماء حيث توجد علامة البادئات.

namespaces

تعريف مجموعة من موجهات الاستيراد لاستخدامها قبل التحويل البرمجي للتجميع.

tagMapping

تعريف مجموعة من أنواع العلامات التي يتم إعادة تعيينها لأنواع علامات أخرى في وقت التحويل برمجياً.

ignoreDeviceFilters

يعرّف مجموعة عناصر الجهاز التي يجب على المستعرض تجاهل أن الصفحة يتم تقديمها. لمزيد من المعلومات، راجع IgnoreDeviceFilters.

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

العنصر

الوصف

configuration

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

system.web

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

ملاحظات

pagesيقوم العنصر بتعريف إعدادات التكوين الخاصة بالصفحة. يعتمد هذا المقطع تكوين إعداد ASP.NET توجيهات صفحة و تحكم معينة بشكل عمومي لكافة الصفحات وعناصر التحكم في نطاق ملف التكوين. يتضمن هذا توجيهات مستوى الصفحة التالية التي تحدد الإعدادات التي يستخدمها المحول البرمجي للصفحة وعنصر تحكم المستخدم عندما يعالج المحول البرمجي صفحة ASP.NET نماذج ويب (.aspx) وملفات عنصر التحكم (.ascx) المستخدم:

pagesكما يوفر العنصر دعم لتعيين أنواع العلامة لأنواع العلامة الأخرى في وقت التشغيل خلال عنصر تعيين العلامة .

ملاحظةملاحظة

إضافة توجيه @ الصفحة إلى صفحة رئيسية لا يسمح باستخدام نفس تعريف التوجيه في الصفحات التي تعتمد على الرئيسية.بدلاً من ذلك، استخدم pagesعنصر التكوين لتعريف موجهات الصفحة بشكل عمومي.

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

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

<pages 
   buffer="true" 
   clientIDMode="AutoID" 
   enableSessionState="true" 
   enableViewState="true" 
   enableViewStateMac="true" 
   smartNavigation="false" 
   autoEventWireup="true" 
   pageBaseType="System.Web.UI.Page" 
   userControlBaseType="System.Web.UI.UserControl" 
   validateRequest="true" 
   masterPageFile="" 
   theme="" 
   styleSheetTheme="" 
   maxPageStateFieldLength="-1" 
   compilationMode="Always" 
   pageParserFilterType="" 
   viewStateEncryptionMode="Auto" 
   maintainScrollPositionOnPostBack="false" 
   asyncTimeout="45"
>
   <namespaces>
      <clear />
   </namespaces>
   <tagMapping>
      <clear />
   </tagMapping>
</pages>

مثال

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

<configuration>
   <system.web>
      <pages buffer="true"
         enableSessionState="true"
         autoEventWireup="true"
         maintainScrollPositionOnPostBack="true"
         masterPageFile = "~/Masters/Page1.master" />
  </system.web>
</configuration>

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

معالج مقطع التكوين

PagesSection

عضو التكوين

Pages

Page

مواقع للتكوين

Machine.config

مستوى جذر ويب.config

مستوى تطبيق ويب.config

دليل المستوى الفعلي أو الظاهري ويب.config

المتطلبات

الإصدار 5.0 أو أحدث من الخدمات معلومات الإنترنت لـ Microsoft (IIS)

إصدارات .NET Framework 1.0 أو أحدث

Microsoft Visual Studio 2003 أو أصدار أحدث.

راجع أيضًا:

المهام

كيفية: تكوين دلائل معينة باستخدام إعدادات الموقع

كيفية: تأمين إعدادات التكوين ASP.NET

المرجع

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

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

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

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

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

@ الصفحة

System.Configuration

System.Web.Configuration

Page

PagesSection

المبادئ

تسلسل هرمي ملف تكوين ASP.NET و الوراثة

تأمين تكوين ASP.NET

موارد أخرى

إعدادات التكوين العامة (ASP.NET)

إعدادات تكوين الـ ASP.NET

إدارة مواقع ويب ASP.NET

تكوين ASP.NET API