أنت غير متصل حاليًا، وفي انتظار الإنترنت الخاص بك ليقوم بإعادة الاتصال

كيف يتم تخزين المعلومات المخصصة واستردادها من ملف تكوين تطبيق باستخدام Visual Basic .NET أو Visual Basic 2005

هام: تمت ترجمة هذا المقال باستخدام برنامج ترجمة آلية لشركة مايكروسوفت بدلاً من الاستعانة بمترجم بشري. تقدم شركة مايكروسوفت كلاً من المقالات المترجمة بواسطة المترجمين البشر والمقالات المترجمة آليًا وبالتالي ستتمكن من الوصول إلى كل المقالات الموجودة في قاعدة المعرفة الخاصة بنا وباللغة الخاصة بك. بالرغم من ذلك، فإن المقالة المترجمة آليًا لا تكون دقيقة دائمًا وقد تحتوي على أخطاء إملائية أو لغوية أو نحوية، مثل تلك الأخطاء الصادرة عن متحدث أجنبي عندما يتحدث بلغتك. لا تتحمل شركة مايكروسوفت مسئولية عدم الدقة أو الأخطاء أو الضرر الناتج عن أية أخطاء في ترجمة المحتوى أو استخدامه من قبل عملائنا. تعمل شركة مايكروسوفت باستمرار على ترقية برنامج الترجمة الآلية

313405
للحصول على إصدار Microsoft C# Visual Microsoft .NET من هذه المقالة، راجع 815786.
الموجز
توضح هذه المقالة كيفية تخزين المعلومات المخصصة في ملف تكوين (.config) يمكنك استردادها فيما بعد أثناء وقت التشغيل بواسطة التطبيق المقترن به. وهذا مفيد عندما تحتاج إلى تعريف البيانات المقترنة مع أحد تطبيقات.


متطلبات

توضح القائمة التالية الأجهزة الموصى بها برامج البنية الأساسية للشبكة و حزم الخدمات التي تحتاجها:
  • نظام التشغيل Microsoft Windows 2000 أو Microsoft Windows XP أو Microsoft Windows Server 2003
  • Microsoft Visual Studio .NET (2002) أو Microsoft Visual Studio .NET (2003) أو Microsoft Visual Studio 2005
تفترض هذه المقالة كنت معتاداً على المواضيع التالية:
  • لغة التوصيف الموسعة (XML)
  • ملفات التكوين .NET

إنشاء تطبيق وحدة التحكم التي قراءات محتوى ملف تكوين

يمكنك تخزين إعدادات التطبيق داخل ملف التكوين المقترنة مع التطبيق. يتم حفظ ملفات التكوين في XML تنسيق. يتضمن System.Configuration مساحات الأسماء System.Collections.Specialized في Microsoft .NET Framework فئات الضرورية لاسترداد معلومات من ملف تكوين تطبيق .NET أثناء وقت التشغيل.

لإنشاء تطبيق وحدة تحكم بقراءة محتويات ملف التكوين المقترنة أثناء وقت التشغيل ، اتبع الخطوات التالية:
  1. بدء تشغيل Visual Studio .NET أو Visual Studio 2005.
  2. إنشاء مشروع "تطبيق وحدة تحكم" جديد يسمى ConConfig في Visual Basic .NET أو 2005 Visual Basic. Visual Basic .NET أو Visual Basic 2005 بإنشاء الوحدة نمطية باسم الوحدة النمطية 1 بشكل افتراضي.
  3. انقر بزر الماوس الأيمن فوق ConConfig في Project المجلد ، أشر إلى إضافة ، ثم انقر فوق إضافة عنصر جديد.

    ملاحظة في Visual Studio 2005 ، انقر بزر الماوس الأيمن فوق ConConfig في Project المجلد، وأشر إلى إضافة ومن ثم انقر فوق عنصر جديد.
  4. في مربع الحوار إضافة عنصر جديد ، حدد قالب ملف تكوين التطبيق انقر فوق فتح ثم قم بإضافة الملف App.config إلى المشروع.

    ملاحظةVisual Studio .NET أو IDE 2005 Visual Studio بنسخ App.Config إلى المجلد حيث يقوم الملف القابل للتنفيذ يتم تحويلها برمجياً ثم إعادة تسمية في <ApplicationName>. <Application Type>.config تنسيق.
  5. يمكنك استخدام ملف تكوين تطبيق لتجميع إعدادات التطبيق المخصص التي قمت بحفظها في تنسيق مفتاح/قيمة. يمكنك تضمين <add> عناصر في <appsettings> المقطع لملف التكوين المقترنة. يحتوي كل زوج قيمة المفتاح على أحد <add> العنصر. <add> العنصر له التنسيق التالي:
    <add key="theKey" value="theValue" />						
    إضافة <appsettings> المقطع مع <add> العناصر إلى ملف تكوين بين العلامات <configuration>و</configuration>. على سبيل المثال، يتضمن ملف التكوين التالية<appsettings> المقطع تحديد ثلاثة مفتاح/قيمة أزواج:
    <?xml version="1.0" encoding="utf-8" ?><configuration>	<appSettings>		<add key="Key0" value="0" />		<add key="Key1" value="1" />		<add key="Key2" value="2" />	</appSettings></configuration>					
  6. في "مستكشف الحلول" انقر نقراً مزدوجاً فوق Module1.vb لعرض إطار التعليمات البرمجية الوحدة النمطية 1. قم بإضافة العبارات التالية إلى الوحدة النمطية للتعليمات البرمجية الخاصة بك:

    ملاحظة يجب أن تظهر هذه العبارات قبل أية عبارات أخرى في ملف.
    Imports System.ConfigurationImports System.Collections.Specialized					
  7. في الإجراء الرئيسي Sub أبعاد متغير سلسلة للاحتفاظ القيمة من مفتاح ملف تكوين في <appsettings> القسم من ملف التكوين:
    Dim sAttr As String					
  8. استرداد قيمة مفتاح محدد من <appsettings> المقطع من ملف التكوين استخدام أسلوب AppSettings فئة ConfigurationSettings. تعتبر فئة ConfigurationSettings في مساحة الاسم System.Configuration. عندما يتلقى أسلوب AppSettings معلمة إدخال سلسلة أحرف يحتوي على مفتاح ، يسترد التطبيق القيمة المقترنة المفتاح.

    استرداد التعليمة البرمجية التالية القيمة للسمة Key0 من ملف التكوين المقترنة. التعليمة البرمجية ثم يضع هذه القيمة في متغير سلسلة sAttr. في حالة عدم وجود مفتاح لهذه القيمة Nothing تخزين في sAttr. sAttr
    sAttr = ConfigurationSettings. AppSettings("Key0")					
  9. لعرض قيمة يقوم باسترداد التطبيق في إطار وحدة التحكم استخدم Console.WriteLine:
    Console.WriteLine("The value of Key0: " & sAttr)					
  10. يمكنك استخدام مرجع واحد إلى خاصية AppSettings لاسترداد كافة أزواج مفتاح/قيمة في <appsettings> المقطع. إذا لم تحدد أية معلمات عند استخدام الخاصية AppSettings التطبيق بإرجاع كافة أزواج مفتاح/قيمة المقترنة. يتم تخزين هذه الأزواج في نوع NameValueCollection الذي يحتوي على إدخالات مفتاح/قيمة لكل مفتاح يسترد التطبيق. فئة NameValueCollection موجودة في مساحة الاسم System.Collections.Specialized.
    Dim sAll As NameValueCollectionsAll = ConfigurationSettings.AppSettings()					
  11. تشير الخاصية AllKeys من NameValueCollection صفيف سلسلة لدى إدخال لكل مفتاح يسترد التطبيق. استخدم بناء بالنسبة التالي تكرار خلال الصفيف AllKeys الوصول إلى كل مفتاح يقوم باسترداد التطبيق. كل إدخال مفتاح في AllKeys هو سلسلة بيانات نوع.
    Dim s As StringFor Each s In sAll.AllKeys					
  12. داخل البناء عن كل استخدام Console.WriteLine لعرض المفتاح وقيمتها المقترنة في وحدة التحكم إطار. المفتاح الحالي الذي يعالج التطبيق قيد "s". استخدم هذا فهرس في sAllNameValueCollection للحصول على القيمة المقترنة الخاصة به.

    على سبيل المثال، إذا كان التطبيق يعالج مفتاح Key0 ، يسترد sAll("Key0") القيمة المقترنة الخاصة به. إيقاف العبارة Console.Readline وحدة التحكم. يمكنك ضغط ENTER لإنهاء التطبيق.
        Console.WriteLine("Key: " & s & " Value: " & sAll(s))NextConsole.Readline					

تحقق من التي من عمل

اضغط المفتاح F5 لتشغيل التعليمات البرمجية. يجب عرض إطار وحدة التحكم أزواج مفتاح/قيمة من <appsettings> ملف مقطع التكوين المقترنة كما يلي:
The value of Key0: 0Key: Key0 Value:0Key: Key1 Value:1Key: Key2 Value:2					

إتمام سرد التعليمات البرمجية

Imports System.ConfigurationImports System.Collections.SpecializedModule Module1    Sub Main()        Dim sAttr As String        sAttr = ConfigurationSettings.AppSettings("Key0")        Console.WriteLine("The value of Key0: " & sAttr)                Dim sAll As NameValueCollection        sAll = ConfigurationSettings.AppSettings()        Dim s As String        For Each s In sAll.AllKeys            Console.WriteLine("Key: " & s & " Value: " & sAll(s))        Next		  Console.ReadLine()    End SubEnd Module				

إكمال إدخال (ConConfig.exe.config) ملف تكوين

<configuration>	<appSettings>		<add key="Key0" value="0"/>		<add key="Key1" value="1"/>		<add key="Key2" value="2"/>	</appSettings></configuration>				

استكشاف الأخطاء وإصلاحها

  • يتم حفظ ملف تكوين بتنسيق XML. تأكد من اتباع كافة قواعد بناء جملة XML. تذكر أن XML حساس لحالة الأحرف. إذا لم يتم تكوين XML بشكلٍ جيد أو إذا أخطأت في كتابة عنصر تلقي استثناء System.Configuration.Configuration.

    على سبيل المثال، إذا قمت بإضافة سمة المفتاح <add> العنصر مع الأحرف كبيرة "ن" بدلاً من أحرف صغيرة "ب ،" أو إذا كان <appsettings> يظهر المقطع <appsettings> (مع الحرف كبير "A" بدلاً من صغيرة "a") ، تظهر رسالة خطأ.
  • يجب تضمين ملف التكوين في المشروع.
  • يجب استخدام بناء الجملة التالي لاسم ملف التكوين عندما يتم إنشاء الملف خارج بيئة Visual Studio ولا يجب أن يتواجد في نفس المجلد مثل التطبيق المقترن به:
    ApplicationName. .config ApplicationType
    حيث يكون ApplicationName هو اسم التطبيق ApplicationType هو نوع التطبيق (على سبيل المثال، exe) وهو .config لاحقة المطلوبة.

مراجع
لمزيد من المعلومات، قم بزيارة موقعي MSDN التاليين على الويب:

تحذير: تمت ترجمة هذا المقال تلقائياً

خصائص

رقم الموضوع: 313405 - آخر مراجعة: 12/06/2006 23:18:25 - المراجعة: 5.5

  • Microsoft Visual Basic 2005
  • Microsoft Visual Basic .NET 2003 Standard Edition
  • Microsoft Visual Basic .NET 2002 Standard Edition
  • kbmt kbvs2005swept kbvs2005applies kbconfig kbhowtomaster KB313405 KbMtar
تعليقات
s">