KeyValueConfigurationElement Classe

Definizione

Spazio dei nomi:

System.Configuration

Assembly:

System.Configuration.ConfigurationManager.dll

Pacchetto:

System.Configuration.ConfigurationManager v11.0.0-preview.4.26230.115

Origine:

KeyValueConfigurationElement.cs

Rappresenta un elemento di configurazione che contiene una coppia chiave/valore.

public ref class KeyValueConfigurationElement : System::Configuration::ConfigurationElement

public class KeyValueConfigurationElement : System.Configuration.ConfigurationElement

type KeyValueConfigurationElement = class
    inherit ConfigurationElement

Public Class KeyValueConfigurationElement
Inherits ConfigurationElement

Ereditarietà

Object

ConfigurationElement

KeyValueConfigurationElement

Esempio

Nell'esempio di codice seguente viene illustrato come usare i membri della KeyValueConfigurationElement classe .

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

L'oggetto KeyValueConfigurationElement eredita dalla ConfigurationElement classe di base. L'oggetto ConfigurationElement rappresenta un elemento all'interno di un file di configurazione. L'oggetto KeyValueConfigurationElement può appartenere a una KeyValueConfigurationCollection raccolta.

Costruttori

Nome	Descrizione
KeyValueConfigurationElement(String, String)	Inizializza una nuova istanza della KeyValueConfigurationElement classe in base ai parametri forniti.

Proprietà

Nome	Descrizione
CurrentConfiguration	Ottiene un riferimento all'istanza di Configuration di primo livello che rappresenta la gerarchia di configurazione a cui appartiene l'istanza di ConfigurationElement corrente. (Ereditato da ConfigurationElement)
ElementInformation	Ottiene un oggetto ElementInformation che contiene le informazioni e le funzionalità non personalizzabili dell'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
ElementProperty	Ottiene l'oggetto ConfigurationElementProperty che rappresenta l'oggetto ConfigurationElement stesso. (Ereditato da ConfigurationElement)
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)
Item[ConfigurationProperty]	Ottiene o imposta una proprietà o un attributo di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Item[String]	Ottiene o imposta una proprietà, un attributo o un elemento figlio di questo elemento di configurazione. (Ereditato da ConfigurationElement)
Key	Ottiene la chiave dell'oggetto KeyValueConfigurationElement .
LockAllAttributesExcept	Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement)
LockAllElementsExcept	Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement)
LockAttributes	Ottiene la raccolta di attributi bloccati. (Ereditato da ConfigurationElement)
LockElements	Ottiene la raccolta di elementi bloccati. (Ereditato da ConfigurationElement)
LockItem	Ottiene o imposta un valore che indica se l'elemento è bloccato. (Ereditato da ConfigurationElement)
Properties	Ottiene la raccolta di proprietà.
Value	Ottiene o imposta il valore dell'oggetto KeyValueConfigurationElement .

Metodi

Nome	Descrizione
DeserializeElement(XmlReader, Boolean)	Legge il codice XML dal file di configurazione. (Ereditato da ConfigurationElement)
Equals(Object)	Confronta l'istanza corrente ConfigurationElement con l'oggetto specificato. (Ereditato da ConfigurationElement)
GetHashCode()	Ottiene un valore univoco che rappresenta l'istanza corrente ConfigurationElement . (Ereditato da ConfigurationElement)
GetTransformedAssemblyString(String)	Restituisce la versione trasformata del nome dell'assembly specificato. (Ereditato da ConfigurationElement)
GetTransformedTypeString(String)	Restituisce la versione trasformata del nome del tipo specificato. (Ereditato da ConfigurationElement)
Init()	Imposta l'oggetto KeyValueConfigurationElement sullo stato iniziale.
InitializeDefault()	Utilizzato per inizializzare un set predefinito di valori per l'oggetto ConfigurationElement. (Ereditato da ConfigurationElement)
IsModified()	Indica se questo elemento di configurazione è stato modificato dopo l'ultimo salvataggio o caricamento, se implementato in una classe derivata. (Ereditato da ConfigurationElement)
IsReadOnly()	Ottiene un valore che indica se l'oggetto ConfigurationElement è di sola lettura. (Ereditato da ConfigurationElement)
ListErrors(IList)	Aggiunge gli errori di proprietà non validi in questo oggetto ConfigurationElement e in tutti i sottoelementi all'elenco passato. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedAttribute(String, String)	Ottiene un valore che indica se viene rilevato un attributo sconosciuto durante la deserializzazione. (Ereditato da ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Ottiene un valore che indica se durante la deserializzazione viene rilevato un elemento sconosciuto. (Ereditato da ConfigurationElement)
OnRequiredPropertyNotFound(String)	Genera un'eccezione quando non viene trovata una proprietà obbligatoria. (Ereditato da ConfigurationElement)
PostDeserialize()	Chiamato dopo la deserializzazione. (Ereditato da ConfigurationElement)
PreSerialize(XmlWriter)	Chiamato prima della serializzazione. (Ereditato da ConfigurationElement)
Reset(ConfigurationElement)	Reimposta lo stato interno dell'oggetto ConfigurationElement , inclusi i blocchi e gli insiemi di proprietà. (Ereditato da ConfigurationElement)
ResetModified()	Reimposta il valore del IsModified() metodo su false quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SerializeElement(XmlWriter, Boolean)	Scrive il contenuto di questo elemento di configurazione nel file di configurazione quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)	Scrive i tag esterni di questo elemento di configurazione nel file di configurazione quando implementato in una classe derivata. (Ereditato da ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Imposta una proprietà sul valore specificato. (Ereditato da ConfigurationElement)
SetReadOnly()	Imposta la IsReadOnly() proprietà per l'oggetto ConfigurationElement e tutti i sottoelementi. (Ereditato da ConfigurationElement)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Modifica l'oggetto ConfigurationElement per rimuovere tutti i valori che non devono essere salvati. (Ereditato da ConfigurationElement)

Vedi anche

• ConfigurationElement