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

للحصول على إصدار Microsoft Microsoft Visual C#.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 في 2005 Visual Basic أو Visual Basic.NET. .NET في Visual Basic أو Visual Basic 2005 إنشاء الوحدة نمطية باسم الوحدة النمطية 1 بشكل افتراضي.
  3. انقر بالزر الأيمن ConConfig
    مجلد المشروع، أشر إلى إضافة، ومن ثم انقر فوق إضافة عنصر جديد.

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

    ملاحظة: Visual Studio.NET أو Visual Studio 2005 IDE نسخ App.Config للمجلد حيث يتم التحويل البرمجي للملف القابل للتنفيذ وإعادة تسمية في < ApplicationName >. < "نوع التطبيق" >.config تنسيق.
  5. يمكنك استخدام ملف تكوين تطبيق لتجميع إعدادات التطبيقات المخصصة التي تقوم بحفظها بتنسيق المفتاح/القيمة. يمكنك تضمين عناصر < إضافة > في قسم < appSettings > من ملف التكوين المقترنة. لدى كل زوج مفتاح/قيمة عنصر < إضافة > . عنصر < إضافة > يحتوي على التنسيق التالي:
    <add key="theKey" value="theValue" />
    إضافة مقطع < appSettings > < إضافة > العناصر إلى ملف تكوين بين التكوين < > و </تكوين > علامات التمييز. على سبيل المثال، يتضمن ملف التكوين التالي مقطع < 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 لعرض إطار التعليمات البرمجية Module1. قم بإضافة العبارات التالية إلى الوحدة النمطية للتعليمات البرمجية الخاصة بك:

    ملاحظة: يجب أن تظهر هذه البيانات قبل أي بيانات في الملف.
    Imports System.ConfigurationImports System.Collections.Specialized

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

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

  11. تشير الخاصية اللكييس من ناميفالوكوليكتيون صفيف سلسلة يحتوي على إدخال لكل مفتاح استرداد التطبيق. استخدم بناء للتالي ليكرر خلال كل مفتاح استرداد التطبيق الوصول إلى الصفيف اللقيس . كل إدخال مفتاح في اللقيس نوع بيانات سلسلة.
    Dim s As StringFor Each s In sAll.AllKeys

  12. داخل المبنى لكل استخدام Console.WriteLine لعرض المفتاح والقيمه المقترنة الخاصة به في إطار وحدة التحكم. المفتاح الحالي الذي يعالج التطبيق قيد "s". استخدام هذا فهرس في سألناميفالوكوليكشن للحصول على القيمة المقترنة الخاصة به.

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

العودة إلى أعلى

تحقق من أنه يعمل

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

العودة إلى أعلى

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

Imports System.ConfigurationImports System.Collections.Specialized

Module 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 Sub

End 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.

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

المراجع

لمزيد من المعلومات، قم بزيارة مواقع ويب MSDN التالي:العودة إلى أعلى
خصائص

رقم الموضوع: 313405 - آخر مراجعة: 18‏/01‏/2017 - المراجعة: 1

تعليقات