Configuration.AppSettings Property

Definition

Namespace:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Package:

System.Configuration.ConfigurationManager v9.0.0-rc.2.24473.5

Source:

Configuration.cs

Gets the AppSettingsSection object configuration section that applies to this Configuration object.

public:
 property System::Configuration::AppSettingsSection ^ AppSettings { System::Configuration::AppSettingsSection ^ get(); };

public System.Configuration.AppSettingsSection AppSettings { get; }

member this.AppSettings : System.Configuration.AppSettingsSection

Public ReadOnly Property AppSettings As AppSettingsSection

Property Value

AppSettingsSection

An AppSettingsSection object representing the appSettings configuration section that applies to this Configuration object.

Examples

The following code example demonstrates how to use the AppSettings property.

try
{
    AppSettingsSection appSettings =
        config.AppSettings as AppSettingsSection;
    Console.WriteLine("Section name: {0}",
            appSettings.SectionInformation.SectionName);

    // Get the AppSettings section elements.
    Console.WriteLine();
    Console.WriteLine("Using AppSettings property.");
    Console.WriteLine("Application settings:");
    // Get the KeyValueConfigurationCollection 
    // from the configuration.
    KeyValueConfigurationCollection settings =
      config.AppSettings.Settings;

    // Display each KeyValueConfigurationElement.
    foreach (KeyValueConfigurationElement keyValueElement in settings)
    {
        Console.WriteLine("Key: {0}", keyValueElement.Key);
        Console.WriteLine("Value: {0}", keyValueElement.Value);
        Console.WriteLine();
    }
}
catch (ConfigurationErrorsException e)
{
    Console.WriteLine("Using AppSettings property: {0}",
        e.ToString());
}

Try
    Dim appSettings As AppSettingsSection = TryCast(config.AppSettings, AppSettingsSection)
    Console.WriteLine("Section name: {0}", appSettings.SectionInformation.SectionName)

    ' Get the AppSettings section elements.
    Console.WriteLine()
    Console.WriteLine("Using AppSettings property.")
    Console.WriteLine("Application settings:")
    ' Get the KeyValueConfigurationCollection 
    ' from the configuration.
    Dim settings As KeyValueConfigurationCollection = config.AppSettings.Settings

    ' Display each KeyValueConfigurationElement.
    For Each keyValueElement As KeyValueConfigurationElement In settings
        Console.WriteLine("Key: {0}", keyValueElement.Key)
        Console.WriteLine("Value: {0}", keyValueElement.Value)
        Console.WriteLine()
    Next keyValueElement
Catch e As ConfigurationErrorsException
    Console.WriteLine("Using AppSettings property: {0}", e.ToString())
End Try

Remarks

Use the AppSettings property to access and change the appSettings configuration section defined by default in the open configuration file.