KeyValueConfigurationCollection Class
.NET Framework 3.0
Contains a collection of KeyValueConfigurationElement objects.
Namespace: System.Configuration
Assembly: System.Configuration (in system.configuration.dll)
Assembly: System.Configuration (in system.configuration.dll)
'Declaration Public Class KeyValueConfigurationCollection Inherits ConfigurationElementCollection 'Usage Dim instance As KeyValueConfigurationCollection
public class KeyValueConfigurationCollection extends ConfigurationElementCollection
public class KeyValueConfigurationCollection extends ConfigurationElementCollection
Not applicable.
The following code example demonstrates how to use the KeyValueConfigurationCollection type.
Imports System Imports System.Collections.Generic Imports System.Text Imports System.Configuration Imports System.Web Imports System.Web.Configuration Namespace Samples.Aspnet.Config Class KeyValueConfigCollection Public Shared Sub Main() Try ' Set the path of the config file. Dim configPath As String = "/aspnet" ' Get the Web application configuration object. Dim config As Configuration = _ WebConfigurationManager.OpenWebConfiguration(configPath) ' Get the section related object. Dim configSection As System.Configuration.AppSettingsSection = _ CType(config.GetSection("appSettings"), System.Configuration.AppSettingsSection) ' Dim configSection As AppSettingsSection = _ ' (AppSettingsSection)config.GetSection("appSettings") ' Display title and info. Console.WriteLine("ASP.NET Configuration Info") Console.WriteLine() ' Display Config details. Console.WriteLine("File Path: {0}", config.FilePath) Console.WriteLine("Section Path: {0}", _ configSection.SectionInformation.Name.ToString()) Console.WriteLine() ' Create the KeyValueConfigurationElement. Dim myAdminKeyVal As KeyValueConfigurationElement = _ New KeyValueConfigurationElement _ ("myAdminTool", "admin.aspx") ' Determine if the configuration contains ' any KeyValueConfigurationElements. Dim configSettings As KeyValueConfigurationCollection = _ config.AppSettings.Settings() If configSettings.AllKeys.Length = 0 Then ' Add KeyValueConfigurationElement to collection. config.AppSettings.Settings.Add(myAdminKeyVal) If Not configSection.SectionInformation.IsLocked Then config.Save() Console.WriteLine("** Configuration updated.") Else Console.WriteLine("** Could not update, section is locked.") End If End If ' Get the KeyValueConfigurationCollection ' from the configuration. Dim settings As KeyValueConfigurationCollection = _ config.AppSettings.Settings() ' Display each KeyValueConfigurationElement. Dim keyValueElement As KeyValueConfigurationElement For Each keyValueElement In settings Console.WriteLine("Key: {0}", keyValueElement.Key) Console.WriteLine("Value: {0}", keyValueElement.Value) Console.WriteLine() Next Catch e As System.ArgumentException ' Unknown error. Console.WriteLine(e.ToString()) End Try ' Display and wait Console.ReadLine() End Sub End Class End Namespace
System.Object
System.Configuration.ConfigurationElement
System.Configuration.ConfigurationElementCollection
System.Configuration.KeyValueConfigurationCollection
System.Configuration.ConfigurationElement
System.Configuration.ConfigurationElementCollection
System.Configuration.KeyValueConfigurationCollection
Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.Community Additions
ADD
Show: