WebConfigurationManager.GetWebApplicationSection(String) Metoda

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

Parametry

Zwraca

Object

Określony obiekt sekcji konfiguracji lub null jeśli sekcja nie istnieje lub wewnętrzny obiekt, jeśli sekcja nie jest dostępna w czasie wykonywania.

Wyjątki

Przykłady

W poniższym przykładzie pokazano, jak uzyskać dostęp do informacji o konfiguracji za pomocą GetWebApplicationSection metody .

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

Uwagi

Jeśli GetWebApplicationSection jest wywoływana z poziomu aplikacji internetowej, pobiera sekcję z pliku konfiguracji wybranego przez system zgodnie z hierarchią konfiguracji aplikacji internetowej.

Wywołanie można wywołać GetWebApplicationSection z poziomu aplikacji klienckiej. W takim przypadku pobiera domyślną sekcję z pliku konfiguracji wybranego przez system zgodnie z hierarchią konfiguracji klienta. Zazwyczaj jest to plik Machine.config, chyba że istnieje zamapowana konfiguracja. W przypadku plików konfiguracji mapowania zapoznaj się z metodami mapowania opisanymi poniżej.

Uwagi dotyczące dziedziczenia

Wartość zwracana musi zostać rzutowania do oczekiwanego typu konfiguracji przed użyciem. Aby uniknąć możliwych wyjątków rzutowania, należy użyć operacji rzutowania warunkowego, takiej jak as operator w języku C#.

Dotyczy

Zobacz też

• ConfigurationSection