عنصر appSettings (مخطط إعدادات عام)

يحتوي على إعدادات تطبيق مخصص مثل مسارات الملفات أو محددات مواقع المعلومات (URL) الخدمة ويب XML أو أية معلومات مخزنة في الملف & .ini & للتطبيق.

عنصر تكوين (مخطط إعدادات عام)
  عنصر appSettings (مخطط إعدادات عام)

<appSettings
   file="relative file name" >
</appSettings>

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

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

السمات

العنصر	الوصف
file	سمة String اختيارية. تعيّن مسار نسبي لملف خارجي يحتوي على إعدادات تكوين التطبيق المخصص. يحتوي الملف المحدد على نفس نوع الإعدادات المحددة في appSettings إضافةو امسح‏‎إزالة إزالة سمات يستخدم نفس مفتاح تنسيق القيمة المزدوج كتلك العناصر. المسار المحدد منسوب إلى ملف التكوين المحلي. يتجاهل وقت التشغيل السمة إذا تعذر العثور على الملف المحدد. أي تغيير في ملف ويب.config يؤدي إلى إعادة تشغيل التطبيق ، استخدام ملف منفصل يسمح للمستخدمين بتعديل القيم الموجودة في appSettingsالمقطع دون التسبب في التطبيق إلى إعادة التشغيل. يتم دمج محتويات الملف المنفصل مع appSettingsالقسم في ملف ويب.config. يقتصر هذا الأداء الوظيفي على appSettingsالسمة. ملاحظة‏‎ في برنامج ‏‫NET Framework. الإصدار 2.0, يمكنك الآن تضمين إعدادات التكوين في ملف منفصل لالكل عناصر التكوين التي تدعم configSourceالسمة. مع ذلك، عند استخدام configSource السمة، عليك نقل المقطع بالكامل في الملف منفصل بسبب عدم وجود دمج لإعدادت العنصر . هناك عملية كتابة لمرة واحدة للملف ويب.config عند استخدام configSourceالسمة. يؤدي ذلك إلى إعادة تشغيل التطبيق ولكن تتم كتابة تحديثات المقطع اللاحقة مباشرة على الملف المنفصل و لا تؤدي إعادة تشغيل التطبيق اللاحقة. لمزيد من المعلومات، راجع ConfigSource.
سمات متوارثة	سمات إختيارية. سمات توريث كل العناصر في المقطع .

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

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

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

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

ملاحظات

appSettings يخزن العنصر معلومات تكوين التطبيق المخصص مثل مسارات ملفات، أو ويب أو خدمة URLs أو أية معلومات يتم تخزينها في الملف .ini لتطبيق ما. أزواج مفتاح/قيمة محددة في appSettings صواب يمكن الوصول إليها في التعليمات البرمجية باستخدام ConfigurationManager class.

يمكنك استخدام fileالسمة لتحديد ملف التكوين الذي يوفر إعدادات إضافية أو يتجاوز الإعدادات المحددة في appSettingsالعنصر. يمكنك استخدام fileالسمة في مصدر عنصر تحكم فريق تطوير السيناريوهات مثل متى يريد المستخدم أن يتجاوز إعدادات المشروع المحددة في ملف تكوين تطبيق. ملفات التكوين المحدد في fileالسمة يجب أن تحتوي على appSettingsالعنصر بدلاً من عنصر التكوين كعقدة الجذر.

في الإصدار 2.0 من تطبيقات NET Framework، خزن سلاسل اتصال قاعدة بيانات في عنصر connectionStrings (مخطط إعدادات ASP.NET)المجموعة بدلاً من مجموعة تطبيق الإعدادات.

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

The following default appSettings element is not explicitly configured in the Machine.config file or in the root Web.config file. ومع ذلك، التكوين الافتراضي هو الذي يتم إرجاعه من قبل التطبيق.

   <appSettings file="">
      <settings>
         <clear />
      </settings>
   </appSettings>

مثال

ملفات التكوين المحدد في fileالسمة يجب أن تحتوي على appSettingsالعنصر بدلاً من عنصر التكوين كعقدة الجذر.

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

<?xml version="1.0" encoding="utf-8" ?>
<appSettings>
<add key="Application1" value="MyApplication1" />
<add key="Setting1" value="MySetting" />
</appSettings>

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

<configuration>
    <appSettings>
        <add key="Application Name" value="MyApplication" />
    </appSettings>
</configuration>

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

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

راجع أيضًا:

المرجع

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

عنصر الأضافة من أجل appSettings (مخطط إعدادات عام)

إزالة عنصر من أجل appSettings (مخطط إعدادات عام)

إزالة عنصر من أجل appSettings (مخطط إعدادات عام)

المبادئ

تأمين تكوين ASP.NET

وحدات سيناريو التكوين ASP.NET

موارد أخرى

إعدادات التكوين العامة (ASP.NET)

إعدادات تكوين الـ ASP.NET

ملفات التكوين ASP.NET