ConfigurationManager.GetSection(String) Yöntem

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Kaynak:

ConfigurationManager.cs

Geçerli uygulamanın varsayılan yapılandırması için belirtilen yapılandırma bölümünü alır.

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

public static object GetSection (string sectionName);

static member GetSection : string -> obj

Public Shared Function GetSection (sectionName As String) As Object

Parametreler

sectionName

String

Yapılandırma bölümü yolu ve adı. Düğüm adları eğik çizgilerle ayrılır, örneğin "system.net/mailSettings/smtp".

Döndürülenler

Object

Belirtilen ConfigurationSection nesne veya null bölüm yoksa.

Özel durumlar

ConfigurationErrorsException

Yapılandırma dosyası yüklenemedi.

Örnekler

Aşağıdaki örnekte yönteminin nasıl kullanılacağı gösterilmektedir GetSection . Örnek, sınıfı için ConfigurationManager sağlanan daha büyük bir örneğin parçasıdır.

// Create the AppSettings section.
// The function uses the GetSection(string)method 
// to access the configuration section. 
// It also adds a new element to the section collection.
public static void CreateAppSettings()
{
  // Get the application configuration file.
  System.Configuration.Configuration config =
    ConfigurationManager.OpenExeConfiguration(
          ConfigurationUserLevel.None);

  string sectionName = "appSettings";

  // Add an entry to appSettings.
  int appStgCnt =
      ConfigurationManager.AppSettings.Count;
  string newKey = "NewKey" + appStgCnt.ToString();

  string newValue = DateTime.Now.ToLongDateString() + 
    " " + DateTime.Now.ToLongTimeString();

  config.AppSettings.Settings.Add(newKey, newValue);

  // Save the configuration file.
  config.Save(ConfigurationSaveMode.Modified);
  
  // Force a reload of the changed section. This 
  // makes the new values available for reading.
  ConfigurationManager.RefreshSection(sectionName);

  // Get the AppSettings section.
  AppSettingsSection appSettingSection =
    (AppSettingsSection)config.GetSection(sectionName);

  Console.WriteLine();
  Console.WriteLine("Using GetSection(string).");
  Console.WriteLine("AppSettings section:");
  Console.WriteLine(
    appSettingSection.SectionInformation.GetRawXml());
}

' Create the AppSettings section.
' The function uses the GetSection(string)method 
' to access the configuration section. 
' It also adds a new element to the section collection.
Public Shared Sub CreateAppSettings()
    ' Get the application configuration file.
    Dim config As System.Configuration.Configuration = _
    ConfigurationManager.OpenExeConfiguration( _
        ConfigurationUserLevel.None)

    Dim sectionName As String = "appSettings"

    ' Add an entry to appSettings.
    Dim appStgCnt As Integer = _
        ConfigurationManager.AppSettings.Count
    Dim newKey As String = _
        "NewKey" + appStgCnt.ToString()

    Dim newValue As String = _
        DateTime.Now.ToLongDateString() + " " + _
        DateTime.Now.ToLongTimeString()

    config.AppSettings.Settings.Add(newKey, _
                                    newValue)

    ' Save the configuration file.
    config.Save(ConfigurationSaveMode.Modified)

    ' Force a reload of the changed section. This 
    ' makes the new values available for reading.
    ConfigurationManager.RefreshSection(sectionName)

    ' Get the AppSettings section.
    Dim appSettingSection As AppSettingsSection = _
        DirectCast(config.GetSection(sectionName),  _
        AppSettingsSection)

    Console.WriteLine()
    Console.WriteLine( _
        "Using GetSection(string).")
    Console.WriteLine( _
        "AppSettings section:")
    Console.WriteLine( _
        appSettingSection.SectionInformation.GetRawXml())
End Sub

Açıklamalar

İstemci uygulamaları için bu yöntem, uygulama yapılandırma dosyasını, yerel kullanıcı yapılandırma dosyasını ve dolaşım yapılandırma dosyasını birleştirerek elde edilen bir yapılandırma dosyasını alır.

yöntemi değiştiremediği GetSection çalışma zamanı yapılandırma bilgilerine erişir. Yapılandırmayı değiştirmek için, aşağıdaki yöntemlerden birini kullanarak aldığınız yapılandırma dosyasında yöntemini kullanırsınız GetSection :

• OpenExeConfiguration

• OpenMachineConfiguration

• OpenMappedExeConfiguration

Devralanlara Notlar

Dönüş değerini beklenen yapılandırma türüne atamanız gerekir. Olası atama özel durumlarını önlemek için C# içindeki işleç veya Visual Basic'teki TryCast işlevi gibi as bir koşullu atama işlemi kullanmanız gerekir.

Ayrıca bkz.

• ConfigurationSection