To view the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

عنصر التحكم

Visual Studio 2010

يعرّف السمات خاصة بتحكم المستخدم (ملفات .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

يشير إلى أن عنصر تحكم يجب أن يكون مترجم باستخدام الوضع OptionStrictVisual 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" %>

إظهار: