KeyValueConfigurationCollection Classe

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v8.0.0

Source:

KeyValueConfigurationCollection.cs

Contiene una raccolta di oggetti KeyValueConfigurationElement.

public ref class KeyValueConfigurationCollection : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.Configuration.KeyValueConfigurationElement))]
public class KeyValueConfigurationCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Configuration.KeyValueConfigurationElement))>]
type KeyValueConfigurationCollection = class
    inherit ConfigurationElementCollection

Public Class KeyValueConfigurationCollection
Inherits ConfigurationElementCollection

Ereditarietà

Object

ConfigurationElement

ConfigurationElementCollection

KeyValueConfigurationCollection

Attributi

ConfigurationCollectionAttribute

Esempio

Nell'esempio di codice seguente viene illustrato come usare il KeyValueConfigurationCollection tipo .

using System;
using System.Collections.Generic;
using System.Text;
using System.Configuration;
using System.Web;
using System.Web.Configuration;

namespace Samples.Aspnet.Config
{
  class KeyValueConfigCollection
  {
    static void Main(string[] args)
    {
      try
      {
        // Set the path of the config file.
        string configPath = "/aspnet";

        // Get the Web application configuration object.
        Configuration config =
          WebConfigurationManager.OpenWebConfiguration(configPath);

        // Get the section related object.
        AppSettingsSection configSection =
          (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.
        KeyValueConfigurationElement myAdminKeyVal = 
          new KeyValueConfigurationElement(
          "myAdminTool", "admin.aspx");

        // Determine if the configuration contains
        // any KeyValueConfigurationElements.
        KeyValueConfigurationCollection configSettings = 
          config.AppSettings.Settings;
        if (configSettings.AllKeys.Length == 0)
        {
          // Add KeyValueConfigurationElement to collection.
          config.AppSettings.Settings.Add(myAdminKeyVal);

          if (!configSection.SectionInformation.IsLocked)
          {
            config.Save();
            Console.WriteLine("** Configuration updated.");
          }
          else
          {
            Console.WriteLine("** Could not update, section is locked.");
          }
        }

        // 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 (Exception e)
      {
        // Unknown error.
        Console.WriteLine(e.ToString());
      }

      // Display and wait
      Console.ReadLine();
    }
  }
}

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

Commenti

Questa classe rappresenta una raccolta di coppie, in cui ogni coppia è costituita da una stringa che funge da chiave di raccolta e da un valore stringa. Poiché il primo elemento è una chiave, deve essere univoco nella raccolta.

Costruttori

KeyValueConfigurationCollection()

Inizializza una nuova istanza della classe KeyValueConfigurationCollection.

Proprietà

AddElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di aggiunta nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
AllKeys	Ottiene le chiavi per tutti gli elementi contenuti nell'insieme KeyValueConfigurationCollection.
ClearElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di cancellazione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
CollectionType	Ottiene il tipo di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
Count	Ottiene il numero di elementi nella raccolta. (Ereditato da ConfigurationElementCollection)
CurrentConfiguration	Ottiene un riferimento all'istanza di Configuration di livello superiore che rappresenta la gerarchia di configurazione cui appartiene l'istanza corrente di ConfigurationElement. (Ereditato da ConfigurationElement)
ElementInformation	Ottiene un oggetto ElementInformation contenente le funzionalità e le informazioni non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
ElementName	Ottiene il nome utilizzato per identificare questo insieme di elementi nel file di configurazione quando è sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
EmitClear	Ottiene o imposta un valore che specifica se l'insieme è stato cancellato. (Ereditato da ConfigurationElementCollection)
EvaluationContext	Ottiene l'oggetto ContextInformation per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
HasContext	Ottiene un valore che indica se la proprietà CurrentConfiguration è null. (Ereditato da ConfigurationElement)
IsSynchronized	Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato. (Ereditato da ConfigurationElementCollection)
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[String]	Ottiene l'oggetto KeyValueConfigurationElement in base al parametro fornito.
LockAllAttributesExcept	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene l'insieme di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene l'insieme di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
Properties	Ottiene un insieme di proprietà di configurazione.
RemoveElementName	Ottiene o imposta il nome della classe ConfigurationElement da associare all'operazione di rimozione nella classe ConfigurationElementCollection quando viene sottoposto a override in un classe derivata. (Ereditato da ConfigurationElementCollection)
SyncRoot	Ottiene un oggetto utilizzato per sincronizzare l'accesso alla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
ThrowOnDuplicate	Ottiene un valore che indica se il tentativo di aggiungere un oggetto KeyValueConfigurationElement duplicato all'insieme KeyValueConfigurationCollection genererà un'eccezione.

Metodi

Add(KeyValueConfigurationElement)	Aggiunge un oggetto KeyValueConfigurationElement all'insieme in base ai parametri forniti.
Add(String, String)	Aggiunge un oggetto KeyValueConfigurationElement all'insieme in base ai parametri forniti.
BaseAdd(ConfigurationElement)	Aggiunge un elemento di configurazione a ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Aggiunge un elemento di configurazione all'insieme di elementi di configurazione. (Ereditato da ConfigurationElementCollection)
BaseClear()	Rimuove tutti gli oggetti dell'elemento di configurazione dall'insieme. (Ereditato da ConfigurationElementCollection)
BaseGet(Int32)	Ottiene l'elemento di configurazione in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseGet(Object)	Restituisce l'elemento di configurazione con la chiave specificata. (Ereditato da ConfigurationElementCollection)
BaseGetAllKeys()	Restituisce una matrice delle chiavi di tutti gli elementi di configurazione inclusi nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseGetKey(Int32)	Ottiene la chiave per la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indica l'indice della classe ConfigurationElement specificata. (Ereditato da ConfigurationElementCollection)
BaseIsRemoved(Object)	Indica se la classe ConfigurationElement con la chiave specificata è stata rimossa dalla classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
BaseRemove(Object)	Rimuove un oggetto ConfigurationElement dalla raccolta. (Ereditato da ConfigurationElementCollection)
BaseRemoveAt(Int32)	Rimuove la classe ConfigurationElement in corrispondenza della posizione di indice specificata. (Ereditato da ConfigurationElementCollection)
Clear()	Elimina l'insieme KeyValueConfigurationCollection.
CopyTo(ConfigurationElement[], Int32)	Copia il contenuto della classe ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection)
CreateNewElement()	Se sottoposto a override in una classe derivata, il metodo CreateNewElement() crea un nuovo oggetto KeyValueConfigurationElement.
CreateNewElement(String)	Crea una nuova classe ConfigurationElement quando è sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta la classe ConfigurationElementCollection con l'oggetto specificato. (Ereditato da ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Ottiene la chiave per un elemento di configurazione specificato quando viene sottoposto a override in un classe derivata.
GetEnumerator()	Ottiene un'interfaccia IEnumerator utilizzata per scorrere la classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetHashCode()	Ottiene un valore univoco che rappresenta l'istanza di ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome di assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Init()	Ripristina lo stato iniziale dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
InitializeDefault()	Da utilizzare per inizializzare un insieme predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
IsElementName(String)	Indica se la classe ConfigurationElement specificata esiste nella classe ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indica se è possibile rimuovere l'oggetto ConfigurationElement da ConfigurationElementCollection. (Ereditato da ConfigurationElementCollection)
IsModified()	Indica se questa classe ConfigurationElementCollection è stata modificata dall'ultimo salvataggio o caricamento durante l'override in una classe derivata. (Ereditato da ConfigurationElementCollection)
IsReadOnly()	Indica se l'oggetto ConfigurationElementCollection è in sola lettura. (Ereditato da ConfigurationElementCollection)
ListErrors(IList)	Aggiunge all'elenco passato gli errori di proprietà non valida di questo oggetto ConfigurationElement e di tutti i sottoelementi. (Ereditato da ConfigurationElement)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene incontrato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Fa generare un'eccezione al sistema di configurazione. (Ereditato da ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando una proprietà obbligatoria non viene trovata. (Ereditato da ConfigurationElement)
PostDeserialize()	Da chiamare dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Da chiamare prima della serializzazione. (Ereditato da ConfigurationElement)
Remove(String)	Rimuove un oggetto KeyValueConfigurationElement dalla raccolta.
Reset(ConfigurationElement)	Reimposta la classe ConfigurationElementCollection sullo stato non modificato quando viene sottoposta a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
ResetModified()	Reimposta il valore della proprietà IsModified() su false quando viene sottoposto a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Scrive i dati di configurazione in un elemento XML del file di configurazione quando vengono sottoposti a override in una classe derivata. (Ereditato da ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione in caso di implementazione in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetReadOnly()	Imposta la proprietà IsReadOnly() per l'oggetto ConfigurationElementCollection e per tutti i sottoelementi. (Ereditato da ConfigurationElementCollection)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverte l'effetto di unione delle informazioni sulla configurazione da livelli diversi della gerarchia di configurazione. (Ereditato da ConfigurationElementCollection)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)

Copia ConfigurationElementCollection in una matrice. (Ereditato da ConfigurationElementCollection)

Metodi di estensione