KeyValueConfigurationElement Klas

Definitie

Vertegenwoordigt een configuratie-element dat een sleutel/waardepaar bevat.

public ref class KeyValueConfigurationElement : System::Configuration::ConfigurationElement
public class KeyValueConfigurationElement : System.Configuration.ConfigurationElement
type KeyValueConfigurationElement = class
    inherit ConfigurationElement
Public Class KeyValueConfigurationElement
Inherits ConfigurationElement
Overname
KeyValueConfigurationElement

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u leden van de KeyValueConfigurationElement klasse gebruikt.

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

Opmerkingen

Het KeyValueConfigurationElement object neemt de basisklasse over ConfigurationElement . Het ConfigurationElement object vertegenwoordigt een element in een configuratiebestand. Het KeyValueConfigurationElement object kan deel uitmaken van een KeyValueConfigurationCollection verzameling.

Constructors

Name Description
KeyValueConfigurationElement(String, String)

Initialiseert een nieuw exemplaar van de KeyValueConfigurationElement klasse op basis van de opgegeven parameters.

Eigenschappen

Name Description
CurrentConfiguration

Hiermee wordt een verwijzing opgehaald naar het exemplaar op het hoogste niveau Configuration dat de configuratiehiërarchie vertegenwoordigt waartoe het huidige ConfigurationElement exemplaar behoort.

(Overgenomen van ConfigurationElement)
ElementInformation

Hiermee haalt u een ElementInformation object op dat de niet-aanpasbare informatie en functionaliteit van het ConfigurationElement object bevat.

(Overgenomen van ConfigurationElement)
ElementProperty

Hiermee haalt u het ConfigurationElementProperty object op dat het ConfigurationElement object zelf vertegenwoordigt.

(Overgenomen van ConfigurationElement)
EvaluationContext

Hiermee haalt u het ContextInformation object voor het ConfigurationElement object op.

(Overgenomen van ConfigurationElement)
HasContext

Hiermee wordt een waarde opgehaald die aangeeft of de CurrentConfiguration eigenschap is null.

(Overgenomen van ConfigurationElement)
Item[ConfigurationProperty]

Hiermee wordt een eigenschap of kenmerk van dit configuratie-element opgehaald of ingesteld.

(Overgenomen van ConfigurationElement)
Item[String]

Hiermee wordt een eigenschap, kenmerk of onderliggend element van dit configuratie-element opgehaald of ingesteld.

(Overgenomen van ConfigurationElement)
Key

Hiermee haalt u de sleutel van het KeyValueConfigurationElement object op.

LockAllAttributesExcept

Hiermee haalt u de verzameling vergrendelde kenmerken op.

(Overgenomen van ConfigurationElement)
LockAllElementsExcept

Hiermee haalt u de verzameling vergrendelde elementen op.

(Overgenomen van ConfigurationElement)
LockAttributes

Hiermee haalt u de verzameling vergrendelde kenmerken op.

(Overgenomen van ConfigurationElement)
LockElements

Hiermee haalt u de verzameling vergrendelde elementen op.

(Overgenomen van ConfigurationElement)
LockItem

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het element is vergrendeld.

(Overgenomen van ConfigurationElement)
Properties

Hiermee haalt u de verzameling eigenschappen op.

Value

Hiermee haalt u de waarde van het object op of stelt u deze KeyValueConfigurationElement in.

Methoden

Name Description
DeserializeElement(XmlReader, Boolean)

Leest XML uit het configuratiebestand.

(Overgenomen van ConfigurationElement)
Equals(Object)

Vergelijkt het huidige ConfigurationElement exemplaar met het opgegeven object.

(Overgenomen van ConfigurationElement)
GetHashCode()

Hiermee haalt u een unieke waarde op die het huidige ConfigurationElement exemplaar vertegenwoordigt.

(Overgenomen van ConfigurationElement)
GetTransformedAssemblyString(String)

Retourneert de getransformeerde versie van de opgegeven assemblynaam.

(Overgenomen van ConfigurationElement)
GetTransformedTypeString(String)

Retourneert de getransformeerde versie van de opgegeven typenaam.

(Overgenomen van ConfigurationElement)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
Init()

Hiermee stelt u het object in op de KeyValueConfigurationElement oorspronkelijke status.

InitializeDefault()

Wordt gebruikt om een standaardset waarden voor het ConfigurationElement object te initialiseren.

(Overgenomen van ConfigurationElement)
IsModified()

Geeft aan of dit configuratie-element is gewijzigd sinds het voor het laatst is opgeslagen of geladen, wanneer dit is geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationElement)
IsReadOnly()

Hiermee wordt een waarde opgehaald die aangeeft of het ConfigurationElement object het kenmerk Alleen-lezen heeft.

(Overgenomen van ConfigurationElement)
ListErrors(IList)

Voegt de fouten met ongeldige eigenschappen in dit ConfigurationElement object en in alle subelementen toe aan de doorgegeven lijst.

(Overgenomen van ConfigurationElement)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
OnDeserializeUnrecognizedAttribute(String, String)

Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend kenmerk wordt aangetroffen tijdens deserialisatie.

(Overgenomen van ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Hiermee wordt een waarde opgehaald die aangeeft of er een onbekend element wordt aangetroffen tijdens deserialisatie.

(Overgenomen van ConfigurationElement)
OnRequiredPropertyNotFound(String)

Genereert een uitzondering wanneer een vereiste eigenschap niet wordt gevonden.

(Overgenomen van ConfigurationElement)
PostDeserialize()

Gebeld na ontserialisatie.

(Overgenomen van ConfigurationElement)
PreSerialize(XmlWriter)

Aangeroepen vóór serialisatie.

(Overgenomen van ConfigurationElement)
Reset(ConfigurationElement)

Hiermee stelt u de interne status van het ConfigurationElement object opnieuw in, inclusief de vergrendelingen en de eigenschappenverzamelingen.

(Overgenomen van ConfigurationElement)
ResetModified()

Hiermee stelt u de waarde van de methode false opnieuw in wanneer deze IsModified() wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationElement)
SerializeElement(XmlWriter, Boolean)

Schrijft de inhoud van dit configuratie-element naar het configuratiebestand wanneer deze wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationElement)
SerializeToXmlElement(XmlWriter, String)

Hiermee schrijft u de buitenste tags van dit configuratie-element naar het configuratiebestand wanneer het wordt geïmplementeerd in een afgeleide klasse.

(Overgenomen van ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Hiermee stelt u een eigenschap in op de opgegeven waarde.

(Overgenomen van ConfigurationElement)
SetReadOnly()

Hiermee stelt u de IsReadOnly() eigenschap voor het ConfigurationElement object en alle subelementen in.

(Overgenomen van ConfigurationElement)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Hiermee wijzigt u het ConfigurationElement object om alle waarden te verwijderen die niet mogen worden opgeslagen.

(Overgenomen van ConfigurationElement)

Van toepassing op

Zie ook