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

يوفر معلومات حول رسائل الخطأ المخصصة أحد تطبيقات ASP.NET. customErrorsيمكن تعريف العنصر في أي المستوى في هيكل ملف التطبيق.

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

<customErrors defaultRedirect="url"
              mode="On|Off|RemoteOnly">
     <error. . ./>
</customErrors>

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

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

السمات

السمة	الوصف
defaultRedirect	السمة الاختيارية تحديد عنوان URL الافتراضي لتوجيه مستعرض إلى ما إذا حدث أي خطأ. عند عدم تحديد هذه السمة يتم عرض خطأ عام بدلاً من ذلك. يمكن أن يكون موقع المعلومات (URL) المطلق (على سبيل المثال، www.contoso.com/ErrorPage.htm) أو نسبي. موقع معلومات نسبي, مثل /ErrorPage.htm، هو نسبة إلى ملف Web.config ذو موقع معلومات URL المحدد الخاص بهذه السمة لا إلى صفحة ويب الذي حدث فيها الخطأ. موقع معلومات تبدأ برمز التلدة (~) ، مثل ~/ErrorPage.htm يشير إلى أن موقع المعلومات المحدد نسبة إلى مسار الجذر من التطبيق.
mode	سمة مطلوبة. تحديد ما إذا كانت الأخطاء المخصصة ممكّنة أو معطّلة أو عرضها فقط للعملاء البعيدين. يمكن أن تكون هذه السمة إحدى القيم التالية. Valueالوصف On تحدد تلك الأخطاء المخصصة الممكّنة .إذا لم defaultRedirectيتم تحديد سمة يرى المستخدمون خطأ عام.الأخطاء المخصصة تظهر للعملاء البعيدين و المضيف المحلي. Off تحدد تلك الأخطاء المخصصة الغير الممكّنة .يتم إظهار أخطاء ASP.NET مفصلة إلى للعملاء البعيدين و إلى المضيف المحلي. RemoteOnly تظهر رسائل الخطأ المخصصة للعملاء البعيدين وتظهر ASP.NET أخطاء المضيف المحلي.هذا الإعداد هو القيمة الافتراضية. يكون الإعداد الافتراضي هو RemoteOnly.

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

العنصر	الوصف
error	عنصر اختياري. يعين خطأ الصفحة المخصصة الخاص بحالة تعليمات HTTP البرمجية المعطاه . يمكن أن تظهر علامة خطأ عدة مرات. يعرّف كل مظهر شرط الخطأ المخصص.

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

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

ملاحظات

<customErrors>لا يتم تطبيق العنصر للأخطاء التي تحدث في خدمات ويب XML.

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

العنصر الافتراضي التالي customErrors مكون في جذر ملف Web.config في الإصدار2.0 من .NET Framework .

<customErrors mode="RemoteOnly" />

مثال

يوضح المثال التالي كيفية تكوين تحديد أخطاء معالجة الصفحات لاستخدام أحد تطبيقات ASP.NET.

<configuration>
  <system.web>
    <customErrors defaultRedirect="GenericError.htm"
                  mode="RemoteOnly">
      <error statusCode="500"
             redirect="InternalError.htm"/>
    </customErrors>
  </system.web>
</configuration>

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

معالج مقطع التكوين	System.Web.Configuration.CustomErrorsSection
عضو التكوين	SystemWebSectionGroup.CustomErrors System.Web.Configuration.CustomErrorsMode
مواقع للتكوين	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

راجع أيضًا:

المهام

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

المرجع

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

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

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

System.Configuration

System.Web.Configuration

المبادئ

نظرة عامة حول تكوين ASP.NET

عناصر تحكم ملقم ويب ASP.NET و قدرات المستعرض

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

وحدات سيناريو التكوين ASP.NET

موارد أخرى

ملفات التكوين ASP.NET

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

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

تكوين ASP.NET API