Bagikan melalui


WebConfigurationManager Kelas

Definisi

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
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:

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

Lihat juga