This article was translated by machine. To view in the article in English, select the English check box. You can also display the English text in a popup window by moving the mouse pointer over the text.
الترجمة
الأصلي
This documentation is archived and is not being maintained.

WebConfigurationManager الفئة

Visual Studio 2010

يوفر الوصول إلى ملفات تكوين كـ ويتم تطبيقها على تطبيقات ويب.

مساحة الاسم:  System.Web.Configuration
التجميع:  System.Web (في System.Web.dll)

public static class WebConfigurationManager

WebConfigurationManager فئة يسمح لك بالوصول إلى الكمبيوتر و تطبيق المعلومات.

استخدام WebConfigurationManagerهي الطريقة المفضلة إلى ملفات العمل مع تكوين تطبيقات ويب إلى ذات الصلة. بالنسبة لتطبيقات العميل، استخدم ConfigurationManagerفئة.

يمكن توسيع تطبيق الخاص بك System.Configurationأنواع أو استخدم مباشرة إلى معالجة معلومات تكوين، كما هو موضح في القائمة التالية:

  • Handling configuration . لمعالجة معلومات تكوين باستخدام أنواع قياسية، استخدم إحدى الطرق التالية:

    • Accessing a section . للوصول إلى معلومات تكوين الخاصة بك تطبيق، يجب عليك استخدام واحد GetSectionالوظائف المتوفرة من قبل WebConfigurationManager. ل <appSettings>و <connectionStrings>، استخدم AppSettingsو ConnectionStringsالخصائص. هذه الطرق بإجراء العمليات القراءة فقط، استخدم مفردة المخزنة مؤقتاً مثيل للتكوين، و multithread على علم.

    • Accessing configuration files . يمكن للتطبيق الخاص بك قراءة وكتابة إعدادات تكوين على أي المستوى، لنفسه أو لأجهزة الكمبيوتر، أو تطبيقات غير ذلك محلياً أو عن بعد. استخدام واحد openالأساليب المتوفرة من قبل WebConfigurationManager. سترجع هذه الأساليب Configurationكائن، والذي بدوره بتوفير أساليب المطلوبة و خصائص إلى hوle الأساسي تكوين ملفات. هذه الطرق لإجراء القراءة أو العمليات الكتابة وإعادة إنشاء بيانات التكوين في كل مرة ملف هو فتح.

    • Advanced configuration . أكثر متقدمة لمعالجة تكوين هو الموفرة من قبل أنواع SectionInformation، PropertyInformation، PropertyInformationCollection، ElementInformation، ContextInformation، ConfigurationSectionGroup، و ConfigurationSectionGroupCollection.

  • Extending configuration standard types . يمكنك أيضا توفير أنواع عناصر تكوين المخصص الخاص بك بواسطة توسيع تكوين القياسية مثل كـ ConfigurationElement، ConfigurationElementCollection، ConfigurationProperty، و ConfigurationSectionباستخدام البرمجي أو عنصر طراز attributed. الرجوع إلى ConfigurationSectionفئة للحصول على مثال عن كيفية توسيع نوع تكوين قياسي بشكل مبرمج. قم بالإشارة إلى ConfigurationElementفئة للحصول على مثال عن كيفية توسيع نوع تكوين قياسي باستخدام طراز attributed.

ملاحظات للقائمين بالتنفيذ

Configuration فئة يسمح بالوصول المبرمج لتحرير ملفات تكوين. استخدام واحد الطرق مفتوحة يوفرها WebConfigurationManager. سترجع هذه الأساليب Configurationكائن، والذي بدوره بتوفير أساليب المطلوبة و خصائص إلى hوle الأساسي تكوين ملفات. يمكنك الوصول إلى هذه الملفات للقراءة أو الكتابة كـ التالي:

يمكنك استخدام GetSectionأو GetSectionGroupإلى قراءة معلومات تكوين. لاحظ أنه يجب أن يكون لدى مستخدم أو عملية قراءة ما يلي أذونات:

  • قراءة إذن في ملف تكوين تشغيل المستوى هيكلي للتكوين الحالي.

  • قراءة أذونات تشغيل الجميع ملفات تكوين الأصلي.

إذا أحتاج تطبيق الخاص بك للقراءة-فقط بالوصول إلى تكوين الخاص به، فإنه هو استخدام GetSectionالأساليب. توفر هذه الطرق للوصول إلى قيم المخزنة مؤقتاً للتكوين الحالي تطبيق، الذي يحتوي على أداء أفضل من Configurationفئة.

ملاحظةملاحظة

إذا كنت تستخدم ثابتة GetSectionالأسلوب الذي يأخذ pathالمعلمة، يجب أن تشير معلمة مسار إلى تطبيق الذي التعليمة البرمجية هو قيد التشغيل؛ otherwهوe، والمعلمة هو تجاهل ومعلومات تكوين للتطبيق تشغيلها حاليا هو التي يتم إرجاعها.

استخدام أحد Saveوظائف إلى كتابة معلومات تكوين. لاحظ أنه يجب أن يكون لدى مستخدم أو عملية كتابة ما يلي أذونات:

  • كتابة الأذونات تشغيل ملف تكوين و الدليل تشغيل المستوى هيكلي للتكوين الحالي.

  • قراءة الأذونات تشغيل الجميع ملفات تكوين.

يلي مثال يوضح كيفية الوصول إلى معلومات تكوين مع WebConfigurationManagerالأسلوب.



        // Show the use of GetSection(string). 
        // It gets the connectiobStrings section.
        // If called from within a client application,
        // the GetSection(string) gets the default connectionStrings
        // section from the machine.config.
        // If called from within a Web aplication it gets the
        // section from the configuration file located at the 
        // application current level. 
        static void GetSection1()
        {

            // Get the connectionStrings section.
            ConnectionStringsSection connectionStringsSection =
                WebConfigurationManager.GetSection("connectionStrings")
                as ConnectionStringsSection;

            // Get the connectionStrings key,value pairs collection.
            ConnectionStringSettingsCollection connectionStrings =
                connectionStringsSection.ConnectionStrings;

            // Get the collection enumerator.
            IEnumerator connectionStringsEnum =
                connectionStrings.GetEnumerator();

            // Loop through the collection and 
            // display the connectionStrings key, value pairs.
            int i = 0;
            Console.WriteLine("[Display the connectionStrings]");
            while (connectionStringsEnum.MoveNext())
            {
                string name = connectionStrings[i].Name;
                Console.WriteLine("Name: {0} Value: {1}",
                name, connectionStrings[name]);
                i += 1;
            }

            Console.WriteLine();
        }



System.Object
  System.Web.Configuration.WebConfigurationManager

يتم تأمين العملية الجزئية لأي عضو عمومي ثابت (مشترك في Visual Basic) من هذا النوع. لن يتم ضمان تأمين العملية الجزئية لأي عضو مثيل.

نظام التشغيل Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, الإصدار x64 من نظام التشغيل Windows XP Professional, Windows XP Starter Edition, Windows Server 2008, نظام التشغيل Windows Server 2003, نظام التشغيل Windows Server 2000 المزود بحزمة الخدمة SP4, نظام التشغيل Windows Millennium Edition, نظام التشغيل Windows 98

لا يدعم .NET Framework و .NET Compact Framework كافة الإصدارات الخاصة بكل نظام أساسي. للحصول على قائمة بالإصدارات المدعمة، راجع متطلبات النظام إطار عمل .NET.

.NET Framework

مدعوم في: 4, 3.5, 3.0, 2.0
إظهار: