WebConfigurationManager Kelas

Referensi

Definisi

Ruang nama:: System.Web.Configuration

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan akses ke file konfigurasi saat diterapkan ke aplikasi Web.

public ref class WebConfigurationManager abstract sealed

public static class WebConfigurationManager

type WebConfigurationManager = class

Public Class WebConfigurationManager

Warisan: Object
WebConfigurationManager

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan

GetSection metode.


// Show how to use the GetSection(string). 
// to access the connectionStrings section.
static void GetConnectionStringsSection()
{

    // 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();
}

' Show how to use the GetSection(string). 
' to access the connectionStrings section.
Shared Sub GetConnectionStringsSection()
   
   ' Get the connectionStrings section.
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetSection("connectionStrings")
   
   ' Get the connectionStrings key,value pairs collection.
     Dim connectionStrings As ConnectionStringSettingsCollection = _
     connectionStringsSection.ConnectionStrings
   
   ' Get the collection enumerator.
     Dim connectionStringsEnum As IEnumerator = _
     connectionStrings.GetEnumerator()
   
   ' Loop through the collection and 
   ' display the connectionStrings key, value pairs.
   Dim i As Integer = 0
   Console.WriteLine("[Display the connectionStrings]")
   While connectionStringsEnum.MoveNext()
      Dim name As String = connectionStrings(i).Name
         Console.WriteLine("Name: {0} Value: {1}", _
         name, connectionStrings(name))
      i += 1
   End While
   
   Console.WriteLine()
End Sub

Keterangan

Kelas ini WebConfigurationManager memungkinkan Anda mengakses informasi komputer dan aplikasi.

Menggunakan WebConfigurationManager adalah cara yang disukai untuk bekerja dengan file konfigurasi yang terkait dengan aplikasi Web. Untuk aplikasi klien, gunakan ConfigurationManager kelas .

Aplikasi Anda dapat memperluas System.Configuration jenis atau menggunakannya secara langsung untuk menangani informasi konfigurasi, seperti yang dijelaskan dalam daftar berikut:

Handling configuration. Untuk menangani informasi konfigurasi menggunakan jenis standar, Anda menggunakan salah satu pendekatan berikut:
- Accessing a section. Untuk mengakses informasi konfigurasi untuk aplikasi, Anda harus menggunakan salah satu metode yang GetSection disediakan oleh WebConfigurationManager. Untuk <appSettings> dan <connectionStrings>, Anda menggunakan AppSettings properti dan ConnectionStrings . Metode ini melakukan operasi baca-saja, menggunakan satu instans konfigurasi cache, dan sadar multithread.
- Accessing configuration files. Aplikasi Anda dapat membaca dan menulis pengaturan konfigurasi di tingkat apa pun, untuk itu sendiri atau untuk aplikasi atau komputer lain, secara lokal atau jarak jauh. Anda menggunakan salah satu metode yang open disediakan oleh WebConfigurationManager. Metode ini akan mengembalikan Configuration objek, yang pada gilirannya menyediakan metode dan properti yang diperlukan untuk menangani file konfigurasi yang mendasar. Metode ini melakukan operasi baca atau tulis dan buat ulang data konfigurasi setiap kali file dibuka.
- Advanced configuration. Penanganan konfigurasi yang lebih canggih disediakan oleh jenis SectionInformation, , PropertyInformation, PropertyInformationCollection, ElementInformation ContextInformation, ConfigurationSectionGroup, dan ConfigurationSectionGroupCollection.
Extending configuration standard types. Anda juga dapat menyediakan elemen konfigurasi kustom dengan memperluas jenis konfigurasi standar seperti ConfigurationElement, , ConfigurationElementCollection ConfigurationProperty, dan ConfigurationSection dengan menggunakan model terprogram atau yang diatribusikan. ConfigurationSection Lihat kelas untuk contoh cara memperluas jenis konfigurasi standar secara terprogram. ConfigurationElement Lihat kelas untuk contoh cara memperluas jenis konfigurasi standar menggunakan model yang diatribusikan.

Catatan Bagi Inheritor

Kelas ini Configuration memungkinkan akses terprogram untuk mengedit file konfigurasi. Anda menggunakan salah satu metode terbuka yang disediakan oleh WebConfigurationManager. Metode ini akan mengembalikan Configuration objek, yang pada gilirannya menyediakan metode dan properti yang diperlukan untuk menangani file konfigurasi yang mendasar. Anda dapat mengakses file-file ini untuk membaca atau menulis sebagai berikut:

Anda menggunakan GetSection(String) atau GetSectionGroup(String) untuk membaca informasi konfigurasi. Perhatikan bahwa pengguna atau proses yang membaca harus memiliki izin berikut:

Izin baca pada file konfigurasi pada tingkat hierarki konfigurasi saat ini.
Membaca izin pada semua file konfigurasi induk.

Jika aplikasi Anda memerlukan akses baca-saja ke konfigurasinya sendiri, disarankan Anda menggunakan metode .GetSection Metode ini menyediakan akses ke nilai konfigurasi cache untuk aplikasi saat ini, yang memiliki performa lebih baik daripada Configuration kelas .

Catatan: Jika Anda menggunakan metode statis GetSection yang mengambil path parameter, parameter jalur harus merujuk ke aplikasi tempat kode berjalan; jika tidak, parameter diabaikan dan informasi konfigurasi untuk aplikasi yang sedang berjalan dikembalikan.

Anda menggunakan salah Save satu metode untuk menulis informasi konfigurasi. Perhatikan bahwa pengguna atau proses yang menulis harus memiliki izin berikut:

Izin tulis pada file konfigurasi dan direktori pada tingkat hierarki konfigurasi saat ini.
Membaca izin pada semua file konfigurasi.

Properti

AppSettings	Mendapatkan pengaturan aplikasi situs Web.
ConnectionStrings	Mendapatkan string koneksi situs Web.

Metode

GetSection(String)	Mengambil bagian konfigurasi yang ditentukan dari file konfigurasi aplikasi Web saat ini.
GetSection(String, String)	Mengambil bagian konfigurasi yang ditentukan dari file konfigurasi aplikasi Web di lokasi yang ditentukan.
GetWebApplicationSection(String)	Mengambil bagian konfigurasi yang ditentukan dari file konfigurasi aplikasi Web saat ini.
OpenMachineConfiguration()	Membuka file konfigurasi komputer pada komputer saat ini sebagai Configuration objek untuk memperbolehkan operasi baca atau tulis.
OpenMachineConfiguration(String)	Membuka file konfigurasi komputer pada komputer saat ini sebagai Configuration objek untuk memperbolehkan operasi baca atau tulis.
OpenMachineConfiguration(String, String)	Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek untuk mengizinkan operasi baca atau tulis.
OpenMachineConfiguration(String, String, IntPtr)	Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek, menggunakan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenMachineConfiguration(String, String, String, String)	Membuka file konfigurasi komputer yang ditentukan pada server yang ditentukan sebagai Configuration objek, menggunakan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenMappedMachineConfiguration(ConfigurationFileMap)	Membuka file konfigurasi komputer sebagai Configuration objek, menggunakan pemetaan file yang ditentukan untuk memungkinkan operasi baca atau tulis.
OpenMappedMachineConfiguration(ConfigurationFileMap, String)	Membuka file konfigurasi komputer sebagai Configuration objek menggunakan pemetaan file dan lokasi yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenMappedWebConfiguration(WebConfigurationFileMap, String)	Membuka file konfigurasi aplikasi Web yang ditentukan sebagai Configuration objek menggunakan pemetaan file dan jalur virtual yang ditentukan untuk memungkinkan operasi baca atau tulis.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String)	Membuka file konfigurasi aplikasi Web yang ditentukan sebagai Configuration objek menggunakan pemetaan file, jalur virtual, dan nama situs yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenMappedWebConfiguration(WebConfigurationFileMap, String, String, String)	Membuka file konfigurasi aplikasi Web yang ditentukan sebagai Configuration objek menggunakan pemetaan file, jalur virtual, nama situs, dan lokasi yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String)	Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String)	Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual dan nama situs yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String, String)	Membuka file konfigurasi Aplikasi web sebagai objek menggunakan Configuration jalur virtual, nama situs, dan lokasi yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String, String, String)	Membuka file konfigurasi Aplikasi web sebagai Configuration objek menggunakan jalur virtual, nama situs, lokasi, dan server yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String, String, String, IntPtr)	Membuka file konfigurasi Aplikasi web sebagai Configuration objek menggunakan jalur virtual, nama situs, lokasi, server, dan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.
OpenWebConfiguration(String, String, String, String, String, String)	Membuka file konfigurasi Aplikasi web sebagai Configuration objek menggunakan jalur virtual, nama situs, lokasi, server, dan konteks keamanan yang ditentukan untuk mengizinkan operasi baca atau tulis.

Berlaku untuk