عنصر التحكم

يعرّف السمات خاصة بتحكم المستخدم (ملفات .ascx) المستخدمة بواسطة محلل ومحول برمجيات الصفحة ASP.NET. يمكن استخدام هذا التوجيه فقط مع (التعليمات برمجية ذات المصدر الخاص به الموجودة في ملفات .ascx). لمزيد من المعلومات حول عناصر التحكم المضيفة ، راجع عناصر تحكم ASP.NET المستخدم.

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

السمات

• AutoEventWireup
  الإشارة إلى ما إذا كانت أحداث عنصر التحكم مربوط سلكيا بشكل أوتوماتيكي. trueإذا كان ربط الحدث أوتوماتيكيا ممكّن; وإلاfalse. يكون الإعداد الافتراضي هو true. لمزيد من المعلومات، راجع طراز أحداث التحكم Server ASP.NET على ويب.

• ClassName
  سلسلة تحدد اسم الفئة لعنصر التحكم المطلوب الذي سيتم تحويله برمجيا بشكل حيوي. يمكن أن تكون هذه القيمة أي اسم الفئة صالح ويمكن أن يتضمن مساحة اسم فئة كاملة (اسم فئة مؤهل بشكل كامل). إذا لم يتم تعيين قيمة هذه السمة اسم فئة لعنصر التحكم المحول برمجيا سيكون استناداً إلى اسم ملف عنصر تحكم.

  صفحة أو عنصر تحكم آخر يمكنه إرجاع اسم الفئة المعينة لعنصر التحكم باستخدام التوجيه @ مرجع.

• ClientIDMode
  يحدد الخوارزمية التي سوف تستخدم لإنشاء ClientIDقيم عناصر التحكم. القيمة الافتراضية للصفحة هي AutoID

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

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

  ملاحظة
  هذه السمة مُضمنة للتوافق مع الإصدارات السابقة من ASP.NET، لتنفيذ الميزة الخلفية للتعليمات برمجية.في ASP.NET الإصدار 2.0 يجب عليك بدلاً من استخدام CodeFileالسمة أن تحدد اسم الملف المصدر مع Inheritsالسمة لتحديد اسم الفئة المؤهل بشكل كامل.

• CodeFile
  يقوم بتعيين مسار الملف المشار إليه الملف الخلفي للتعليمات برمجية المرجع لعنصر التحكم. هذه السمة مستخدمة مع Inheritsسمة لاقتران ملف تعليمات برمجية في الخلف مصدر مع عنصر تحكم المستخدم. السمة صالحة فقط لعناصر التحكم المترجمة.

• CodeFileBaseClass
  تعيين مسار فئة أساسية لعنصر تحكم و فئة التعليمة البرمجية الخلفية المقترنة به. هذه السمة اختيارية ولكن عند استخدامه CodeFileكما يجب أن تكون سمة موجودة. استخدم هذه السمة عند الحاجة إلى تنفيذ سيناريو مشترك حيث تقوم بتعريف حقول مشتركة (والأحداث المقترنة بشكل اختياري) في فئة أساسية للرجوع لعناصر التحكم الموجودة في عنصر تحكم المستخدم. نتيجة لـASP.NET طراز إنشاء التعليمات برمجية، إذا قمت بتعريف الحقول في فئة أساسية دون استخدام هذا السمة، يتم إنشاء عضو تعريف جديد في وقت التحويل برمجياً لعناصر التحكم الموجودة في عنصر تحكم المستخدم (في فئة جزئية منفصلة) قد لا يعمل السيناريو المطلوب. ولكن إذا كنت تستخدم CodeFileBaseClassالسمة لربط الفئة الأساسية مع عنصر تحكم المستخدم وتقوم بإجراء فئة جزئية (تم تعيينه اسمه Inheritsللسمة وملف المصدر تتم الإشارة إليه من CodeFileالسمة) ترث من الفئة الأساسية ثم ستتمكن الحقول الموجودة في الفئة الأساسية من الرجوع لعناصر التحكم الموجودة في عنصر تحكم المستخدم إنشاء التعليمات البرمجية.

• CompilationMode
  تعيين ما إذا كان يجب ان يتم ترجمة عنصر تحكمباستخدام سلسلة تحدد أحد الخيارات العديدة من قائمة تعداد. قيمة افتراضية Always، لذلك يتم تحويلها برمجياً .aspx بواسطة عناصر التحكم بشكل افتراضي. للحصول على تفاصيل، راجع CompilationModeقائمة تعداد.

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

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

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

• EnableTheming
  الإشارة إلى ما إذا كان يتم استخدام الأنساق على عنصر التحكم. trueإذا كانت السمات المستخدمة وإلاfalse. يكون الإعداد الافتراضي هو true.

• EnableViewState
  الإشارة إلى ما إذا كان حالة عرض يتم الاحتفاظ بها عبر طلبات التحكم. trueإذا كانت حالة العرض يتم الاحتفاظ بها وإلاfalse. يكون الإعداد الافتراضي هو true.

• Explicit
  يحدد ما إذا كان يتم ترجمة عنصر تحكم باستخدام وضع Visual Basic Option Explicit. trueتشير إلى أن خيار التحويل برمجياً الصريح لـ Visual Basic ممكن و أن كل المتغيرات يجب تعريفها باستخدامDim, Private, Public, أوReDimكشف; وإلا،false. يكون الإعداد الافتراضي هو false.

  ملاحظة
  يتم تجاهل هذه السمة بواسطة لغات غير Visual Basic.أيضاً، يتم تعيين هذا الخيار لـ trueفي ملف التكوين Machine.config.للمزيد من المعلومات، راجع ملفات التكوين وملفات التكوين ASP.NET.

• Inherits
  تعرّف فئة لتعليمات برمجية في الخلف لعنصر التحكم ليرث. هذه يمكن أن تكون أي فئة مشتقة من UserControl الفئة. يستخدم مع CodeFileالسمة التي تحتوي على المسار للملف المصدر. لفئة التعليمات البرمجية الخلفية. لمزيد من المعلومات حول تعليمات برمجية خلف الفئات، راجع طراز رمز صفحة ASP.NET على ويب.

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

• LinePragmas
  يحدد ما إذا كان يجب على وقت التشغيل إنشاء خط في مصدر التعليمات البرمجية. هذه هي خيارات التحويل البرمجي المستخدمة غالبا من قبل أدوات التصحيح لوضع علامة على مواقع محددة وملف مصدر. trueإذا كان يجب أن تكوين خط pragmas وإلاfalse.

• Src
  يقوم بتعيين ملف المسارالمتضمن تعليمات برمجية مربوطة لعنصر التحكم. في الملف المصدر المرتبط يمكنك اختيار تضمين منطق البرمجة لعنصر التحكم الخاص بك إما في فئة أو في كتل تعليمات برمجية تعريف .

  يمكنك استخدام Srcالسمة لبناء ارتباط موفرين لعنصر التحكم. لمزيد من المعلومات، راجع فئة BuildProvider. أيضاً، في إصدارات ASP.NET قبل إلى 2.0 Srcتم استخدام السمة كطريقة بديلة لربط ملف لتعليمات برمجية في الخلف لعنصر تحكم. في ASP.NET الإصدار 2.0 الأسلوب المفضل لإضافة ارتباطات تعليمة برمجية - خلف الملف المصدر لعنصر تحكم لاستخدامه في Inheritsالسمة لتحديد فئة ما، مع CodeFileالسمة لتحديد المسار إلى الملف المصدر للفئة.

• Strict
  يشير إلى أن عنصر تحكم يجب أن يكون مترجم باستخدام الوضع Option StrictVisual Basic. trueإذا كانOption Strict ممكّن وإلاfalse. يكون الإعداد الافتراضي هو false.

  ملاحظة
  يتم تجاهل هذه السمة بواسطة لغات غير Visual Basic.

• TargetSchema
  تعيين اسم المخطط الذي يقوم بالتحقق من صحة المحتوى في عنصر التحكم. يخدم هذا غرض وصفي فقط; لا يتم تنفيذ التحقق من صحة بشكل فعلي، وسيتم تجاهل السمة بواسطة المحلل اللغوي.

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

ملاحظات

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

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

لتعريف سمات متعددة @ Controlتوجيه افصل كل زوج مكون من سمة وقيمة باستخدام مسافة واحدة. للحصول سمة معينة لا تقم بإضافة مسافة على كلا جانبي العلامة علامة التساوي (=) بهذا الشكل تتصل السمة بقيمتها. على سبيل المثال، راجع المقطع المثال الخاص بهذا الموضوع.

مثال

مثال التعليمة البرمجية التالي يرشد برنامج تحويل الصفحة البرمجي ASP.NET إلى استخدام Visual Basic كلغة تعليمات برمجية مضمنة و تعطيل حفظ حالة العرض عبر طلبات HTTP التي تستخدم EnableViewStateالسمة.

<%@ Control Language="VB" EnableViewState="false" %>

راجع أيضًا:

المرجع

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

@ الصفحة

موارد أخرى

ASP.NET صفحة بناء الجملة

عناصر تحكم ASP.NET المستخدم