WebConfigurationManager.GetWebApplicationSection(String) Metoda

Definicja

Przestrzeń nazw:

System.Web.Configuration

Zestaw:

System.Web.dll

Pobiera określoną sekcję konfiguracji z bieżącego pliku konfiguracji aplikacji internetowej.

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

sectionName

String

Nazwa sekcji konfiguracji.

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

ConfigurationErrorsException

Nie można załadować prawidłowego pliku konfiguracji.

Przykłady

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

Uwaga

W tym przykładzie pokazano, jak za pomocą GetWebApplicationSection metody pobrać ConfigurationSection obiekt z domyślnego pliku konfiguracji.

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

Uwaga

Metoda GetWebApplicationSection to operacja w czasie wykonywania, która działa w sekcji pliku konfiguracji aplikacji znajdującego się na bieżącym poziomie. Metoda GetSection nie jest jednak operacją w czasie wykonywania, ale działa w określonej sekcji uzyskanej za pomocą jednej z metod otwierania plików konfiguracji.

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#.

Zobacz też

• ConfigurationSection