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

مقالة
11/01/2010

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

يعتبر هذا العنصر جديدا في ‏‫NET Framework. الإصدار 2.0.

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

<controls> 
   <add /> 
</controls>

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

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

السمات

لا يوجد.

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

العنصر	الوصف
add	عنصر اختياري. تضيف بادئة علامة إلى مجموعة البادئات العلامة المستخدمة أثناء pre-compilation.

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

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

ملاحظات

controlsتعريف مجموعة من موجهات التسجيل و مساحات الأسماء أين توجد البادئات العلامة. يتوافق مع هذا العنصر إلى تسجيل اشتراكالتوجيه على الصفحة ASP.NET. @ Registerيسمح لك صواب تعيين بادئة علامة لعنصر تحكم مستخدم.

إقران البادئات العلامة مساحة اسم في ASP.NET إلى التجميعات و مساحات الاسم التي يجب مُضمن عناصر تحكم COM والمستخدم للعمل بشكل صحيح. المعلومات التالية مفيدة عند تكوين controlsالعنصر:

في حالة تطبيق إلى عنصر تحكم مستخدم يجب عليك تعريف في tagPrefix، tagName, و sourceسمات إضافة عنصر فرع .
في حالة تطبيق إلى عنصر تحكم مستخدم يجب عليك تعريف في tagPrefix، namespace, و assemblyسمات إضافة عنصر فرع . assemblyالسمة غير مطلوبة، إذا كان عنصر تحكم في تعليمات برمجية للتطبيق الدليل.

يمكنك استخدام نفس tagPrefixالقيمة إلى مخطط إلى متعددة التجميعات أو مساحات الأسماء.

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

العنصر التالي الافتراضي controlsمكون في ملف ويب.config الجذر.

<pages>
   <controls>
      <add 
         tagPrefix="asp" 
         namespace="System.Web.UI.WebControls.WebParts" 
         assembly="System.Web, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" 
      />
   </controls>
   <!-- Other elements -->
</pages>

مثال

يلي تعليمات برمجية يوضح المثال كيفية تحديد قيم العديد من السمات عنصر عناصر التحكم والتي يمكن أيضاً الوصول برمجياً كالأعضاء TagPrefixInfoفئة. بشكل إلزامي

   <pages>
      <controls>
         <!—- Searches all linked assemblies for the namespace -->
         <add 
            tagPrefix="MyTags1" 
            namespace="MyNameSpace"/>
         <!-- Uses a specified assembly -->
         <add 
            tagPrefix="MyTags2"
            namespace="MyNameSpace" 
            assembly="MyAssembly"/>
         <!-- Uses the specified source for the user control -->
         <add 
            tagPrefix="MyTags3" 
            tagName="MyCtrl" 
            source="MyControl.ascx"/>
      </controls>
   </pages>

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

معالج مقطع التكوين	PagesSection
عضو التكوين	Controls TagPrefixCollection
مواقع للتكوين	Machine.config مستوى جذر ويب.config مستوى تطبيق ويب.config الدليل–المستوى ويب.config الفعلية أو الظاهرية
المتطلبات	Microsoft Internet Information Services (IIS) الإصدار 5.0 أو 5.1 أو 6.0. .NET Framework، الإصدار 2.0 Microsoft Visual Studio 2003 أو Visual Studio 2005

راجع أيضًا:

مشاركة عبر

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

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

السمات

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

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

ملاحظات

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

مثال

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

راجع أيضًا:

المهام

المرجع

المبادئ

موارد أخرى

الموارد الإضافية