KeyValueConfigurationCollection Klasa

Definicja

Zawiera kolekcję KeyValueConfigurationElement obiektów.Contains a collection of KeyValueConfigurationElement objects.

public ref class KeyValueConfigurationCollection : System::Configuration::ConfigurationElementCollection
[System.Configuration.ConfigurationCollection(typeof(System.Configuration.KeyValueConfigurationElement))]
public class KeyValueConfigurationCollection : System.Configuration.ConfigurationElementCollection
public class KeyValueConfigurationCollection : System.Configuration.ConfigurationElementCollection
[System.Configuration.ConfigurationCollection(typeof(System.Configuration.KeyValueConfigurationElement), CollectionType=System.Configuration.ConfigurationElementCollectionType.AddRemoveClearMap)]
public class KeyValueConfigurationCollection : System.Configuration.ConfigurationElementCollection
[<System.Configuration.ConfigurationCollection(typeof(System.Configuration.KeyValueConfigurationElement))>]
type KeyValueConfigurationCollection = class
    inherit ConfigurationElementCollection
type KeyValueConfigurationCollection = class
    inherit ConfigurationElementCollection
[<System.Configuration.ConfigurationCollection(typeof(System.Configuration.KeyValueConfigurationElement), CollectionType=System.Configuration.ConfigurationElementCollectionType.AddRemoveClearMap)>]
type KeyValueConfigurationCollection = class
    inherit ConfigurationElementCollection
Public Class KeyValueConfigurationCollection
Inherits ConfigurationElementCollection
Dziedziczenie
Atrybuty

Przykłady

Poniższy przykład kodu demonstruje, jak używać KeyValueConfigurationCollection typu.The following code example demonstrates how to use the KeyValueConfigurationCollection type.

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

Uwagi

Ta klasa reprezentuje kolekcję par, gdzie każda para składa się z ciągu, który służy jako klucz kolekcji i wartość ciągu.This class represents a collection of pairs, where each pair consists of a string serving as a collection key and a string value. Ponieważ pierwszy element jest kluczem, musi być unikatowy w całej kolekcji.Because the first element is a key, it must be unique across the collection.

Konstruktory

KeyValueConfigurationCollection()

Inicjuje nowe wystąpienie klasy KeyValueConfigurationCollection.Initializes a new instance of the KeyValueConfigurationCollection class.

Właściwości

AddElementName

Pobiera lub ustawia nazwę, ConfigurationElement która ma zostać skojarzona z operacją dodawania w ConfigurationElementCollection przypadku zastąpienia w klasie pochodnej.Gets or sets the name of the ConfigurationElement to associate with the add operation in the ConfigurationElementCollection when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
AllKeys

Pobiera klucze do wszystkich elementów zawartych w KeyValueConfigurationCollection kolekcji.Gets the keys to all items contained in the KeyValueConfigurationCollection collection.

ClearElementName

Pobiera lub ustawia nazwę, ConfigurationElement która ma zostać skojarzona z operacją Clear w ConfigurationElementCollection klasie pochodnej.Gets or sets the name for the ConfigurationElement to associate with the clear operation in the ConfigurationElementCollection when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
CollectionType

Pobiera typ ConfigurationElementCollection .Gets the type of the ConfigurationElementCollection.

(Odziedziczone po ConfigurationElementCollection)
Count

Pobiera liczbę elementów w kolekcji.Gets the number of elements in the collection.

(Odziedziczone po ConfigurationElementCollection)
CurrentConfiguration

Pobiera odwołanie do wystąpienia najwyższego poziomu Configuration , które reprezentuje hierarchię konfiguracji, do której ConfigurationElement należy bieżące wystąpienie.Gets a reference to the top-level Configuration instance that represents the configuration hierarchy that the current ConfigurationElement instance belongs to.

(Odziedziczone po ConfigurationElement)
ElementInformation

Pobiera ElementInformation obiekt, który zawiera informacje, które nie są dostosowywane i funkcje ConfigurationElement obiektu.Gets an ElementInformation object that contains the non-customizable information and functionality of the ConfigurationElement object.

(Odziedziczone po ConfigurationElement)
ElementName

Pobiera nazwę używaną do identyfikowania tej kolekcji elementów w pliku konfiguracji, gdy jest zastępowana w klasie pochodnej.Gets the name used to identify this collection of elements in the configuration file when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
ElementProperty

Pobiera ConfigurationElementProperty obiekt, który reprezentuje ConfigurationElement sam obiekt.Gets the ConfigurationElementProperty object that represents the ConfigurationElement object itself.

(Odziedziczone po ConfigurationElement)
EmitClear

Pobiera lub ustawia wartość określającą, czy kolekcja została wyczyszczona.Gets or sets a value that specifies whether the collection has been cleared.

(Odziedziczone po ConfigurationElementCollection)
EvaluationContext

Pobiera ContextInformation obiekt dla ConfigurationElement obiektu.Gets the ContextInformation object for the ConfigurationElement object.

(Odziedziczone po ConfigurationElement)
HasContext

Pobiera wartość wskazującą, czy CurrentConfiguration Właściwość jest null .Gets a value that indicates whether the CurrentConfiguration property is null.

(Odziedziczone po ConfigurationElement)
IsSynchronized

Pobiera wartość wskazującą, czy dostęp do kolekcji jest synchronizowany.Gets a value indicating whether access to the collection is synchronized.

(Odziedziczone po ConfigurationElementCollection)
Item[ConfigurationProperty]

Pobiera lub ustawia właściwość lub atrybut tego elementu konfiguracji.Gets or sets a property or attribute of this configuration element.

(Odziedziczone po ConfigurationElement)
Item[String]

Pobiera KeyValueConfigurationElement obiekt na podstawie podanego parametru.Gets the KeyValueConfigurationElement object based on the supplied parameter.

LockAllAttributesExcept

Pobiera kolekcję zablokowanych atrybutów.Gets the collection of locked attributes.

(Odziedziczone po ConfigurationElement)
LockAllElementsExcept

Pobiera kolekcję zablokowanych elementów.Gets the collection of locked elements.

(Odziedziczone po ConfigurationElement)
LockAttributes

Pobiera kolekcję zablokowanych atrybutów.Gets the collection of locked attributes.

(Odziedziczone po ConfigurationElement)
LockElements

Pobiera kolekcję zablokowanych elementów.Gets the collection of locked elements.

(Odziedziczone po ConfigurationElement)
LockItem

Pobiera lub ustawia wartość wskazującą, czy element jest zablokowany.Gets or sets a value indicating whether the element is locked.

(Odziedziczone po ConfigurationElement)
Properties

Pobiera kolekcję właściwości konfiguracji.Gets a collection of configuration properties.

RemoveElementName

Pobiera lub ustawia nazwę elementu ConfigurationElement do skojarzenia z operacją usuwania w ConfigurationElementCollection przypadku zastąpienia w klasie pochodnej.Gets or sets the name of the ConfigurationElement to associate with the remove operation in the ConfigurationElementCollection when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
SyncRoot

Pobiera obiekt służący do synchronizowania dostępu do ConfigurationElementCollection .Gets an object used to synchronize access to the ConfigurationElementCollection.

(Odziedziczone po ConfigurationElementCollection)
ThrowOnDuplicate

Pobiera wartość wskazującą, czy próba dodania zduplikowanego KeyValueConfigurationElement obiektu do KeyValueConfigurationCollection kolekcji spowoduje zgłoszenie wyjątku.Gets a value indicating whether an attempt to add a duplicate KeyValueConfigurationElement object to the KeyValueConfigurationCollection collection will cause an exception to be thrown.

Metody

Add(KeyValueConfigurationElement)

Dodaje KeyValueConfigurationElement obiekt do kolekcji na podstawie podanych parametrów.Adds a KeyValueConfigurationElement object to the collection based on the supplied parameters.

Add(String, String)

Dodaje KeyValueConfigurationElement obiekt do kolekcji na podstawie podanych parametrów.Adds a KeyValueConfigurationElement object to the collection based on the supplied parameters.

BaseAdd(ConfigurationElement)

Dodaje element konfiguracji do ConfigurationElementCollection .Adds a configuration element to the ConfigurationElementCollection.

(Odziedziczone po ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)

Dodaje element konfiguracji do kolekcji elementów konfiguracji.Adds a configuration element to the configuration element collection.

(Odziedziczone po ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)

Dodaje element konfiguracji do kolekcji elementów konfiguracji.Adds a configuration element to the configuration element collection.

(Odziedziczone po ConfigurationElementCollection)
BaseClear()

Usuwa wszystkie obiekty elementów konfiguracji z kolekcji.Removes all configuration element objects from the collection.

(Odziedziczone po ConfigurationElementCollection)
BaseGet(Int32)

Pobiera element konfiguracji w określonej lokalizacji indeksu.Gets the configuration element at the specified index location.

(Odziedziczone po ConfigurationElementCollection)
BaseGet(Object)

Zwraca element konfiguracji z określonym kluczem.Returns the configuration element with the specified key.

(Odziedziczone po ConfigurationElementCollection)
BaseGetAllKeys()

Zwraca tablicę kluczy dla wszystkich elementów konfiguracji zawartych w ConfigurationElementCollection .Returns an array of the keys for all of the configuration elements contained in the ConfigurationElementCollection.

(Odziedziczone po ConfigurationElementCollection)
BaseGetKey(Int32)

Pobiera klucz dla ConfigurationElement określonej lokalizacji indeksu.Gets the key for the ConfigurationElement at the specified index location.

(Odziedziczone po ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)

Wskazuje indeks określonego elementu ConfigurationElement .Indicates the index of the specified ConfigurationElement.

(Odziedziczone po ConfigurationElementCollection)
BaseIsRemoved(Object)

Wskazuje, czy ConfigurationElement z określonym kluczem został usunięty z ConfigurationElementCollection .Indicates whether the ConfigurationElement with the specified key has been removed from the ConfigurationElementCollection.

(Odziedziczone po ConfigurationElementCollection)
BaseRemove(Object)

Usuwa ConfigurationElement z kolekcji.Removes a ConfigurationElement from the collection.

(Odziedziczone po ConfigurationElementCollection)
BaseRemoveAt(Int32)

Usuwa z ConfigurationElement określonej lokalizacji indeksu.Removes the ConfigurationElement at the specified index location.

(Odziedziczone po ConfigurationElementCollection)
Clear()

Czyści KeyValueConfigurationCollection kolekcję.Clears the KeyValueConfigurationCollection collection.

CopyTo(ConfigurationElement[], Int32)

Kopiuje zawartość ConfigurationElementCollection do tablicy.Copies the contents of the ConfigurationElementCollection to an array.

(Odziedziczone po ConfigurationElementCollection)
CreateNewElement()

Gdy jest zastępowany w klasie pochodnej, CreateNewElement() Metoda tworzy nowy KeyValueConfigurationElement obiekt.When overridden in a derived class, the CreateNewElement() method creates a new KeyValueConfigurationElement object.

CreateNewElement(String)

Tworzy nowy, ConfigurationElement gdy jest zastępowany w klasie pochodnej.Creates a new ConfigurationElement when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)

Odczytuje dane XML z pliku konfiguracyjnego.Reads XML from the configuration file.

(Odziedziczone po ConfigurationElement)
Equals(Object)

Porównuje ConfigurationElementCollection do określonego obiektu.Compares the ConfigurationElementCollection to the specified object.

(Odziedziczone po ConfigurationElementCollection)
GetElementKey(ConfigurationElement)

Pobiera klucz elementu dla określonego elementu konfiguracji, gdy jest zastępowany w klasie pochodnej.Gets the element key for a specified configuration element when overridden in a derived class.

GetEnumerator()

Pobiera, IEnumerator który jest używany do iteracji przez ConfigurationElementCollection .Gets an IEnumerator which is used to iterate through the ConfigurationElementCollection.

(Odziedziczone po ConfigurationElementCollection)
GetHashCode()

Pobiera unikatową wartość reprezentującą ConfigurationElementCollection wystąpienie.Gets a unique value representing the ConfigurationElementCollection instance.

(Odziedziczone po ConfigurationElementCollection)
GetTransformedAssemblyString(String)

Zwraca przekształconą wersję określonej nazwy zestawu.Returns the transformed version of the specified assembly name.

(Odziedziczone po ConfigurationElement)
GetTransformedTypeString(String)

Zwraca przekształconą wersję określonej nazwy typu.Returns the transformed version of the specified type name.

(Odziedziczone po ConfigurationElement)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
Init()

Ustawia ConfigurationElement obiekt do stanu początkowego.Sets the ConfigurationElement object to its initial state.

(Odziedziczone po ConfigurationElement)
InitializeDefault()

Służy do inicjowania domyślnego zestawu wartości dla ConfigurationElement obiektu.Used to initialize a default set of values for the ConfigurationElement object.

(Odziedziczone po ConfigurationElement)
IsElementName(String)

Wskazuje, czy określony ConfigurationElement istnieje w ConfigurationElementCollection .Indicates whether the specified ConfigurationElement exists in the ConfigurationElementCollection.

(Odziedziczone po ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)

Wskazuje, czy ConfigurationElement można usunąć określony z ConfigurationElementCollection .Indicates whether the specified ConfigurationElement can be removed from the ConfigurationElementCollection.

(Odziedziczone po ConfigurationElementCollection)
IsModified()

Wskazuje, czy został on ConfigurationElementCollection zmodyfikowany od momentu ostatniego zapisania lub załadowania w przypadku zastąpienia w klasie pochodnej.Indicates whether this ConfigurationElementCollection has been modified since it was last saved or loaded when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
IsReadOnly()

Wskazuje, czy ConfigurationElementCollection obiekt jest tylko do odczytu.Indicates whether the ConfigurationElementCollection object is read only.

(Odziedziczone po ConfigurationElementCollection)
ListErrors(IList)

Dodaje błędy nieprawidłowej właściwości w tym ConfigurationElement obiekcie i we wszystkich podelementach do listy zakończonych.Adds the invalid-property errors in this ConfigurationElement object, and in all subelements, to the passed list.

(Odziedziczone po ConfigurationElement)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnDeserializeUnrecognizedAttribute(String, String)

Pobiera wartość wskazującą, czy podczas deserializacji napotkano nieznany atrybut.Gets a value indicating whether an unknown attribute is encountered during deserialization.

(Odziedziczone po ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)

Powoduje zgłoszenie wyjątku przez system konfiguracji.Causes the configuration system to throw an exception.

(Odziedziczone po ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)

Zgłasza wyjątek, gdy wymagana właściwość nie zostanie znaleziona.Throws an exception when a required property is not found.

(Odziedziczone po ConfigurationElement)
PostDeserialize()

Wywoływana po deserializacji.Called after deserialization.

(Odziedziczone po ConfigurationElement)
PreSerialize(XmlWriter)

Wywoływana przed serializacji.Called before serialization.

(Odziedziczone po ConfigurationElement)
Remove(String)

Usuwa KeyValueConfigurationElement obiekt z kolekcji.Removes a KeyValueConfigurationElement object from the collection.

Reset(ConfigurationElement)

Resetuje ConfigurationElementCollection do stanu niezmodyfikowanego w przypadku zastąpienia w klasie pochodnej.Resets the ConfigurationElementCollection to its unmodified state when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
ResetModified()

Resetuje wartość IsModified() właściwości na, false gdy została przesłonięta w klasie pochodnej.Resets the value of the IsModified() property to false when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)

Zapisuje dane konfiguracji do elementu XML w pliku konfiguracji, gdy jest zastępowany w klasie pochodnej.Writes the configuration data to an XML element in the configuration file when overridden in a derived class.

(Odziedziczone po ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)

Zapisuje zewnętrzne Tagi tego elementu konfiguracji w pliku konfiguracji po zaimplementowaniu w klasie pochodnej.Writes the outer tags of this configuration element to the configuration file when implemented in a derived class.

(Odziedziczone po ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)

Ustawia właściwość na określoną wartość.Sets a property to the specified value.

(Odziedziczone po ConfigurationElement)
SetReadOnly()

Ustawia IsReadOnly() Właściwość dla ConfigurationElementCollection obiektu i dla wszystkich elementów podrzędnych.Sets the IsReadOnly() property for the ConfigurationElementCollection object and for all sub-elements.

(Odziedziczone po ConfigurationElementCollection)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)

Odwraca efekt scalania informacji o konfiguracji z różnych poziomów hierarchii konfiguracji.Reverses the effect of merging configuration information from different levels of the configuration hierarchy.

(Odziedziczone po ConfigurationElementCollection)

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)

Kopiuje ConfigurationElementCollection do tablicy.Copies the ConfigurationElementCollection to an array.

(Odziedziczone po ConfigurationElementCollection)

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable do IQueryable .Converts an IEnumerable to an IQueryable.

Dotyczy