مشاركة عبر

@ WebHandler

  • مقالة

تعرّف السمات وخيارات التحويل البرمجي لملفات معالج (.ashx) HTTP.

<%@ WebHandler attribute="value" [attribute="value"...] %>

السمات

  • Class
    تعيّن اسم الفئة التي سوف يتم ترجمتها بشكل حيوي عند طلبها المعالج. يمكن أن تشير هذه القيمة إلى أي فئة ترث من IHttpHandlerويمكن أن يتضمن بشكل كامل مؤهل اسم الفئة.

  • CodeBehind
    تعيين اسم الملف المحول برمجيا الذي يحتوي على الفئة المقترنة بعنصر التحكم. هذه السمة غير مستخدمة في وقت التشغيل.

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

    هذه السمة مُضمنة للتوافق مع الإصدارات السابقة من ASP.NET .

  • CompilerOptions
    تعيين السلسلة التي تحتوي على الخيارات المستخدمة إلى ترجمة المعالج. في C# و Visual Basic ، هذا تسلسل مفاتيح التبديل الموجودة بخط أوامر برنامج التحويل البرمجي. للحصول على معلومات أكثر راجع المعلومات حول خيارات برنامج التحويل البرمجي، راجع (خيارات المحول البرمجي #C)أو المحول البرمجي Visual Basic.

  • Debug
    trueإذا كان يجب تجميع عنصر التحكم مع رموز التصحيح وإلاfalse. لأن هذا الإعداد يؤثر على أداء تعيين السمة إلى trueفقط أثناء التطوير.

  • Description
    توفر وصفاً نصياً من المعالج. يتم تجاهل هذه القيمة بواسطة محلل ASP.NET.

  • Language
    تحدد اللغة المستخدمة عند ترجمة كل التعليمات البرمجية ضمن المعالج. يمكن أن تمثل القيم أي لغة معتمدة من قبل .NET Framework "، بما في ذلك Visual Basic أو C# أو JScript. لغة واحدة فقط يمكن استخدامها لكل معالج.

  • WarningLevel
    يشير إلى مستوى تحذير برنامج التحويل البرمجي الذي تريد من المحول البرمجي لمعاملة التحذيرات والأخطاء, وبالتالي إحباط التحويل البرمجي لعنصر تحكم. مستويات تحذير المحتملة هي من 0 إلى 4. لمزيد من المعلومات، انظر الخاصية WarningLevel.

ملاحظات

توجيه هذا صالحاً فقط في ملفات استخدام معالجات HTTP. بشكل افتراضي، يعامل ASP.NET الملفات ذات ملحق .ashx اسم الملف كمعالجات.

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

إذا لم تكن تريد استخدام ملحق اسم الملف .ashx للمعالجات الخاصة بك ، فيمكنك إنشاء معالج كفئة قياسية (ملف .cs أو .vb) التي تقوم بتنفيذ IHttpHandlerالواجهة.لا يتطلب ملف فئة المعالج @ WebHandler توجيهات.يجب تسجيل ملحق اسم الملف المفضل لديك ثم مع ASP.NET.للمزيد من التفاصيل ، راجع كيفية: تسجيل معالجات HTTP.

يمكنك تضمين @ WebHandlerتوجيه واحد فقط لكل ملف. بشكل إضافي, يمكنك تعريف Languageسمة لكل @ WebHandler وجيه، لأنه يمكن استخدام لغة واحدة فقط لكل عنصر تحكم.

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

@ WebHandlerالتوجيه يحتوي على عدد من السمات المشتركة مع توجيهات الأخرى التي تنطبق على ملف المصدر بالكامل مثل @Page التوجيه (المستخدم في ملفات aspx. لصفحات ويب) و التوجيه (المستخدم في ملفات .شكل رئيسي الخاص بالصفحات الرئيسية).

لتعريف سمات متعددة @ WebHandlerتوجيه افصل كل زوج مكون من سمة وقيمة باستخدام مسافة واحدة. لا تقم بتضمين مسافة على كلا جانبي علامة التساوي (=) اتصال السمة مع القيمة الخاصة بها.

مثال

في المثال التالي يرشد برنامج التحويل البرمجي الصفحة ASP.NET ليُستخدم Visual Basic لغة تعليمات برمجية مضمنة مثال التعليمة البرمجية التالية كما يعيّن اسم فئة.

<%@ WebHandler Language="VB" Class="MyTestHandler" %>

راجع أيضًا:

المرجع

قالب النص بناء الجملة التوجيهي

@ الصفحة

IHttpHandler

Handlers

المبادئ

معالجات HTTP و نظرة عامة حول الوحدات النمطية لـ HTTP