عنصر 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>
معلومات العنصر
معالج مقطع التكوين |
|
عضو التكوين |
|
مواقع للتكوين |
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 (مخطط إعدادات عام)