عنصر connectionStrings (مخطط إعدادات ASP.NET)

مقالة
11/01/2010

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

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

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

<connectionStrings > 
   <add />
   <clear />
   <remove />
</connectionStrings>

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

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

السمات

لا شيء, باستثناء سمات الموروثة بواسطة كل عناصر المقطع. لمزيد من المعلومات، راجع سمات عامة موروثة من عناصر القسم. تطبيقات ASP.NET n في وقت التشغيل "، يمكنك تعيين إلى ConfigSourceالسمة اسم ملف التكوين البديل. في هذه الحالة، يتم الكتابة فوق محتوى الملف بواسطة معلومات سلسلة الاتصال الافتراضية الموجودة في ملف ويب.config. كما يحدث هذا عند عدم وجود الملف بديل تم إنشاؤها أثناء وقت التشغيل. إذا لم يتضمن ويب.config معلومات سلسلة الاتصال أي فارغ connectionStringsتمت الإضافة قسم إلى ملف بديلة.

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

العنصر	الوصف
Add	إضافة سلسلة اتصال أنه ينشئ ازدواجًا اسم/القيمة إلى مجموعة سلاسل اتصال.
Clear	إزالة كافة المراجع إلى سلاسل اتصال الموروثة السماح سلاسل اتصال التي يضيفها فقط صواب عنصر إضافة .
remove	يزيل مرجع إلى عبارة عن سلسلة اتصال موروثة من مجموعة سلاسل الاتصالات.

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

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

ملاحظات

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

تم تخزين سلاسل الاتصال في الإصدارات السابقة من ASP.NET في appSettings . تعتمد في ASP.NET 2.0 الميزات، مثل جلسة عمل و عضوية إضفاء طابع شخصي و إدارة الأدوار على سلاسل الاتصالات التي تم تخزينها في connectionStringsالعنصر. يمكنك أيضاً استخدام connectionStringsعنصر لتخزين سلاسل اتصال التطبيقات الخاصة بك.

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

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

يمكنك الوصول إلى connectionStringsعنصر برمجياً. لمزيد من المعلومات، انظر الملف التمهيدي.ConnectionStrings

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

مثال

يوضح مثال التعليمة البرمجية التالية كيف إلى تكوين اتصال سلسلتين. يمكن استخدام سلسلة الاتصال الأول بواسطة أحد تطبيقات ASP.NET ويُستخدم الثاني سلسلة الاتصال قبل العنصر sqlCacheDependency والذي تم تكوينه لاحقًا.

<configuration>
<!-- Other configuration settings -->

<connectionStrings>

  <add name="Sales" 
       providerName="System.Data.SqlClient"
       connectionString= "server=myserver;database=Products;uid=<user name>;pwd=<secure password>" />

  <add name="NorthWind" 
       providerName="System.Data.SqlClient" 
       connectionString="server=.;database=NorthWind;Integrated Security=SSPI" />

</connectionStrings>

<cache>
  <sqlCacheDependency enabled="true" pollTime="60000">
    <databases>
      <add name="Northwind" />
    </databases>
  </sqlCacheDependency>
</cache>

</configuration>

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

معالج مقطع التكوين	ConnectionStringsSection
عضو التكوين	ConnectionStringSettingsCollection ConnectionStrings ConnectionStrings ConnectionStrings
مواقع للتكوين	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

راجع أيضًا:

مشاركة عبر

عنصر connectionStrings (مخطط إعدادات ASP.NET)

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

السمات

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

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

ملاحظات

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

مثال

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

راجع أيضًا:

المهام

المرجع

المبادئ

موارد أخرى

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