WebConfigurationManager.GetWebApplicationSection(String) Metode

Definisi

Ruang nama:

System.Web.Configuration

Rakitan:

System.Web.dll

Mengambil bagian konfigurasi yang ditentukan dari file konfigurasi aplikasi Web saat ini.

public:
 static System::Object ^ GetWebApplicationSection(System::String ^ sectionName);

public static object GetWebApplicationSection(string sectionName);

static member GetWebApplicationSection : string -> obj

Public Shared Function GetWebApplicationSection (sectionName As String) As Object

Parameter

sectionName

String

Nama bagian konfigurasi.

Mengembalikan

Object

Objek bagian konfigurasi yang ditentukan, atau null jika bagian tidak ada, atau objek internal jika bagian tidak dapat diakses pada waktu proses.

Pengecualian

ConfigurationErrorsException

File konfigurasi yang valid tidak dapat dimuat.

Contoh

Contoh berikut menunjukkan cara mengakses informasi konfigurasi dengan GetWebApplicationSection metode .

Note

Contoh ini menunjukkan cara menggunakan GetWebApplicationSection metode untuk mendapatkan ConfigurationSection objek dari file konfigurasi default.

// Show the use of GetWebApplicationSection(string).
// to get the connectionStrings section.
 static void GetWebApplicationSection()
 {

     // Get the default connectionStrings section,
     ConnectionStringsSection connectionStringsSection =
         WebConfigurationManager.GetWebApplicationSection(
         "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 connectionStrings]");
     while (connectionStringsEnum.MoveNext())
     {
         string name = connectionStrings[i].Name;
         Console.WriteLine("Name: {0} Value: {1}",
         name, connectionStrings[name]);
         i += 1;
     }

     Console.WriteLine();
 }

' Show the use of GetWebApplicationSection(string). 
' to access the connectionStrings section.
Shared Sub GetWebApplicationSection()
   
   ' Get the default connectionStrings section,
     Dim connectionStringsSection As ConnectionStringsSection = _
     WebConfigurationManager.GetWebApplicationSection( _
     "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 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

Jika GetWebApplicationSection dipanggil dari dalam aplikasi Web, itu mendapatkan bagian dari file konfigurasi yang dipilih oleh sistem sesuai dengan hierarki konfigurasi aplikasi Web.

Anda dapat memanggil GetWebApplicationSection dari dalam aplikasi klien. Dalam hal ini, ia mendapatkan bagian default dari file konfigurasi yang dipilih oleh sistem sesuai dengan hierarki konfigurasi klien. Biasanya, ini adalah file Machine.config, kecuali Anda memiliki konfigurasi yang dipetakan. Untuk memetakan file konfigurasi, lihat metode pemetaan yang dijelaskan berikutnya.

Note

Metode GetWebApplicationSection ini adalah operasi run-time yang bertindak pada bagian file konfigurasi aplikasi yang terletak di tingkat saat ini. Metode ini GetSection , bagaimanapun, bukan operasi run-time tetapi bertindak pada bagian yang ditentukan yang diperoleh melalui salah satu metode untuk membuka file konfigurasi.

Catatan Bagi Inheritor

Nilai yang dikembalikan harus dilemparkan ke jenis konfigurasi yang diharapkan sebelum digunakan. Untuk menghindari kemungkinan pengecualian transmisi, Anda harus menggunakan operasi transmisi kondisional seperti as operator di C#.

Lihat juga

• ConfigurationSection