عنصر الإضافة لـ connectionStrings (مخطط إعدادات ASP.NET)

مقالة
11/01/2010

إضافة سلسلة اتصال أنه ينشئ ازدواجًا اسم/القيمة إلى مجموعة سلاسل اتصال.

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

عنصر تكوين (مخطط إعدادات عام)
عنصر connectionStrings (مخطط إعدادات ASP.NET)
عنصر الإضافة لـ connectionStrings (مخطط إعدادات ASP.NET)

<add 
   name="connection string name"
   connectionString="connection string"
   providerName="ADO.NET data provider" 
/>

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

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

السمات

السمة	الوصف
connectionString	سمة String مطلوبة. تعريف القيمة سلسلة الاتصال. يمكن أن تكون القيمة سلسلة فارغة (""). يتم إجراء لا تدقيق إلى التحقق من صحة الخاص به. الافتراضي عبارة عن سلسلة فارغة.
name	سمة String مطلوبة. تعريف القيمة سلسلة الاتصال للوصول إلى المفتاح. هذه السمة تتجاوز أي المفتاح الموروثة بنفس الاسم. الافتراضي عبارة عن سلسلة فارغة.
providerName	سمة String اختيارية. اسم موفر ADO.NET لاستخدامه في الوصول إلى مخزن البيانات المصدر. يكون الإعداد الافتراضي هو "System.Data.SqlClient".
سمات متوارثة	سمات إختيارية. سمات توريث كل العناصر في المقطع . لمزيد من المعلومات، راجع سمات عامة موروثة من عناصر القسم.

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

لا يوجد.

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

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

ملاحظات

add سلسلة اتصال كما يضيف العنصر صواب / قيمة زوج إلى مجموعة سلاسل اتصال في عنصر connectionStrings .

تحديد مجموعة من سلاسل اتصال قاعدة بيانات ، زوج الاسم/القيمة لتطبيقات وميزات ASP.NET .

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

تورث سلاسل الاتصالات الموجودة في ملف تكوين أصل ما لم يُستخدم العنصر قم بإلغاء تحديدها في ملف التكوين الفرعة. العنصر التالي الافتراضي elementمكون في ملف ويب.config الجذر.

<connectionStrings>
   <add 
      name="LocalSqlServer" 
      connectionString="data source=.\SQLEXPRESS;Integrated Security=SSPI;AttachDBFilename=|DataDirectory|aspnetdb.mdf;User Instance=true" 
      providerName="System.Data.SqlClient"
   />
</connectionStrings>

مثال

يوضح المثال تعليمات برمجية التالي كيفية تكوين سلسلة الاتصال التطبيق الذي يستخدم قاعدة بيانات Northwind.

<configuration>
  <connectionStrings>
    <add name="Northwind"
         connectionString="Data Source=localhost;Integrated Security=SSPI;Initial Catalog=Northwind;" 
         providerName="System.Data.SqlClient" />
  </connectionStrings>
</configuration>

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

معالج مقطع التكوين	ConnectionStringsSection
عضو التكوين	Add(ConnectionStringSettings)
مواقع للتكوين	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

راجع أيضًا:

مشاركة عبر