KeyValueConfigurationCollection Sınıf

Tanım

Ad Alanı:

System.Configuration

Bütünleştirilmiş Kod:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Kaynak:

KeyValueConfigurationCollection.cs

Bir nesne koleksiyonu KeyValueConfigurationElement içerir.

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

Devralma

Object

ConfigurationElement

ConfigurationElementCollection

KeyValueConfigurationCollection

Öznitelikler

ConfigurationCollectionAttribute

Örnekler

Aşağıdaki kod örneğinde türün nasıl kullanılacağı gösterilmektedir KeyValueConfigurationCollection .

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

Açıklamalar

Bu sınıf, her çiftin bir koleksiyon anahtarı ve dize değeri olarak hizmet veren bir dizeden oluştuğu çift koleksiyonunu temsil eder. İlk öğe bir anahtar olduğundan, koleksiyon genelinde benzersiz olmalıdır.

Oluşturucular

KeyValueConfigurationCollection()

KeyValueConfigurationCollection sınıfının yeni bir örneğini başlatır.

Özellikler

AddElementName	türetilmiş bir sınıfta geçersiz kılındığında içindeki ConfigurationElementCollection ekleme işlemiyle ilişkilendirilecek öğesinin adını ConfigurationElement alır veya ayarlar. (Devralındığı yer: ConfigurationElementCollection)
AllKeys	Koleksiyondaki KeyValueConfigurationCollection tüm öğelerin anahtarlarını alır.
ClearElementName	türetilmiş bir sınıfta geçersiz kılındığında içindeki clear işlemiyle ilişkilendirilecek öğesinin ConfigurationElementCollection adını ConfigurationElement alır veya ayarlar. (Devralındığı yer: ConfigurationElementCollection)
CollectionType	türünü ConfigurationElementCollectionalır. (Devralındığı yer: ConfigurationElementCollection)
Count	Koleksiyondaki öğe sayısını alır. (Devralındığı yer: ConfigurationElementCollection)
CurrentConfiguration	Geçerli ConfigurationElement örneğin ait olduğu yapılandırma hiyerarşisini temsil eden en üst düzey Configuration örneğe başvuru alır. (Devralındığı yer: ConfigurationElement)
ElementInformation	Özelleştirilebilir olmayan bilgileri ve nesnenin işlevselliğini ConfigurationElement içeren bir ElementInformation nesnesi alır. (Devralındığı yer: ConfigurationElement)
ElementName	Türetilmiş bir sınıfta geçersiz kılındığında yapılandırma dosyasındaki bu öğe koleksiyonunu tanımlamak için kullanılan adı alır. (Devralındığı yer: ConfigurationElementCollection)
ElementProperty	Nesnenin ConfigurationElementProperty kendisini temsil ConfigurationElement eden nesneyi alır. (Devralındığı yer: ConfigurationElement)
EmitClear	Koleksiyonun temizlenip temizlenmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: ConfigurationElementCollection)
EvaluationContext	Nesnenin ContextInformation nesnesini ConfigurationElement alır. (Devralındığı yer: ConfigurationElement)
HasContext	özelliğinin nullolup olmadığını CurrentConfiguration belirten bir değer alır. (Devralındığı yer: ConfigurationElement)
IsSynchronized	Koleksiyona erişimin eşitlenip eşitlenmediğini belirten bir değer alır. (Devralındığı yer: ConfigurationElementCollection)
Item[ConfigurationProperty]	Bu yapılandırma öğesinin bir özelliğini veya özniteliğini alır veya ayarlar. (Devralındığı yer: ConfigurationElement)
Item[String]	Sağlanan parametreye KeyValueConfigurationElement göre nesnesini alır.
LockAllAttributesExcept	Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockAllElementsExcept	Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockAttributes	Kilitli özniteliklerin koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockElements	Kilitli öğeler koleksiyonunu alır. (Devralındığı yer: ConfigurationElement)
LockItem	Öğesinin kilitli olup olmadığını belirten bir değer alır veya ayarlar. (Devralındığı yer: ConfigurationElement)
Properties	Yapılandırma özellikleri koleksiyonunu alır.
RemoveElementName	türetilmiş bir sınıfta geçersiz kılındığında içindeki kaldırma işlemiyle ilişkilendirilecek öğesinin ConfigurationElementCollection adını ConfigurationElement alır veya ayarlar. (Devralındığı yer: ConfigurationElementCollection)
SyncRoot	öğesine erişimi ConfigurationElementCollectioneşitlemek için kullanılan bir nesneyi alır. (Devralındığı yer: ConfigurationElementCollection)
ThrowOnDuplicate	Koleksiyona yinelenen KeyValueConfigurationElement bir nesne ekleme girişiminin KeyValueConfigurationCollection bir özel durum oluşturulup oluşturulmayacağını belirten bir değer alır.

Yöntemler

Add(KeyValueConfigurationElement)	Sağlanan parametrelere göre koleksiyona bir KeyValueConfigurationElement nesne ekler.
Add(String, String)	Sağlanan parametrelere göre koleksiyona bir KeyValueConfigurationElement nesne ekler.
BaseAdd(ConfigurationElement)	öğesine ConfigurationElementCollectionbir yapılandırma öğesi ekler. (Devralındığı yer: ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Yapılandırma öğesi koleksiyonuna bir yapılandırma öğesi ekler. (Devralındığı yer: ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Yapılandırma öğesi koleksiyonuna bir yapılandırma öğesi ekler. (Devralındığı yer: ConfigurationElementCollection)
BaseClear()	Koleksiyondan tüm yapılandırma öğesi nesnelerini kaldırır. (Devralındığı yer: ConfigurationElementCollection)
BaseGet(Int32)	Belirtilen dizin konumunda yapılandırma öğesini alır. (Devralındığı yer: ConfigurationElementCollection)
BaseGet(Object)	Belirtilen anahtarla yapılandırma öğesini döndürür. (Devralındığı yer: ConfigurationElementCollection)
BaseGetAllKeys()	içinde yer alan tüm yapılandırma öğeleri için anahtarların bir dizisini ConfigurationElementCollectiondöndürür. (Devralındığı yer: ConfigurationElementCollection)
BaseGetKey(Int32)	Belirtilen dizin konumunda anahtarını ConfigurationElement alır. (Devralındığı yer: ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Belirtilen ConfigurationElementöğesinin dizinini gösterir. (Devralındığı yer: ConfigurationElementCollection)
BaseIsRemoved(Object)	Belirtilen anahtara sahip öğesinin öğesinden ConfigurationElementCollectionkaldırılıp kaldırılmadığını ConfigurationElement gösterir. (Devralındığı yer: ConfigurationElementCollection)
BaseRemove(Object)	ConfigurationElement Bir öğesini koleksiyondan kaldırır. (Devralındığı yer: ConfigurationElementCollection)
BaseRemoveAt(Int32)	Belirtilen dizin konumunda öğesini ConfigurationElement kaldırır. (Devralındığı yer: ConfigurationElementCollection)
Clear()	Koleksiyonu temizler KeyValueConfigurationCollection .
CopyTo(ConfigurationElement[], Int32)	öğesinin ConfigurationElementCollection içeriğini bir diziye kopyalar. (Devralındığı yer: ConfigurationElementCollection)
CreateNewElement()	Türetilmiş bir sınıfta geçersiz kılındığında yöntemi CreateNewElement() yeni KeyValueConfigurationElement bir nesne oluşturur.
CreateNewElement(String)	Türetilmiş bir sınıfta geçersiz kılındığında yeni ConfigurationElement bir oluşturur. (Devralındığı yer: ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Yapılandırma dosyasından XML okur. (Devralındığı yer: ConfigurationElement)
Equals(Object)	öğesini ConfigurationElementCollection belirtilen nesneyle karşılaştırır. (Devralındığı yer: ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Türetilmiş bir sınıfta geçersiz kılındığında belirtilen yapılandırma öğesinin öğe anahtarını alır.
GetEnumerator()	aracılığıyla ConfigurationElementCollectionyinelemek için kullanılan bir IEnumerator alır. (Devralındığı yer: ConfigurationElementCollection)
GetHashCode()	Örneği temsil eden ConfigurationElementCollection benzersiz bir değer alır. (Devralındığı yer: ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Belirtilen derleme adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement)
GetTransformedTypeString(String)	Belirtilen tür adının dönüştürülmüş sürümünü döndürür. (Devralındığı yer: ConfigurationElement)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
Init()	ConfigurationElement Nesneyi başlangıç durumuna ayarlar. (Devralındığı yer: ConfigurationElement)
InitializeDefault()	Nesne için varsayılan değer kümesini başlatmak için ConfigurationElement kullanılır. (Devralındığı yer: ConfigurationElement)
IsElementName(String)	Belirtilen ConfigurationElement öğesinin içinde ConfigurationElementCollectionmevcut olup olmadığını gösterir. (Devralındığı yer: ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Belirtilen ConfigurationElement öğesinin öğesinden ConfigurationElementCollectionkaldırılıp kaldırılamayacağını gösterir. (Devralındığı yer: ConfigurationElementCollection)
IsModified()	ConfigurationElementCollection Türetilmiş bir sınıfta geçersiz kılındığında son kaydedildiğinden veya yüklendiğinden bu yana değiştirilip değiştirilmediğini gösterir. (Devralındığı yer: ConfigurationElementCollection)
IsReadOnly()	Nesnenin ConfigurationElementCollection salt okunur olup olmadığını gösterir. (Devralındığı yer: ConfigurationElementCollection)
ListErrors(IList)	Bu ConfigurationElement nesnedeki ve tüm alt öğelerdeki invalid-property hatalarını geçirilen listeye ekler. (Devralındığı yer: ConfigurationElement)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
OnDeserializeUnrecognizedAttribute(String, String)	Seri durumdan çıkarma sırasında bilinmeyen bir öznitelikle karşılaşılıp karşılaşılmadığını belirten bir değer alır. (Devralındığı yer: ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Yapılandırma sisteminin özel durum oluşturmasına neden olur. (Devralındığı yer: ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Gerekli bir özellik bulunamadığında bir özel durum oluşturur. (Devralındığı yer: ConfigurationElement)
PostDeserialize()	Seri durumdan çıkarıldıktan sonra çağrılır. (Devralındığı yer: ConfigurationElement)
PreSerialize(XmlWriter)	Serileştirmeden önce çağrılır. (Devralındığı yer: ConfigurationElement)
Remove(String)	Bir KeyValueConfigurationElement nesneyi koleksiyondan kaldırır.
Reset(ConfigurationElement)	türetilmiş bir sınıfta geçersiz kılındığında öğesini değiştirilmemiş durumuna sıfırlar ConfigurationElementCollection . (Devralındığı yer: ConfigurationElementCollection)
ResetModified()	Türetilmiş bir sınıfta geçersiz kılındığında özelliğinin IsModified()false değerini olarak sıfırlar. (Devralındığı yer: ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Türetilmiş bir sınıfta geçersiz kılındığında yapılandırma verilerini yapılandırma dosyasındaki bir XML öğesine yazar. (Devralındığı yer: ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Türetilmiş bir sınıfta uygulandığında bu yapılandırma öğesinin dış etiketlerini yapılandırma dosyasına yazar. (Devralındığı yer: ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Belirtilen değere bir özellik ayarlar. (Devralındığı yer: ConfigurationElement)
SetReadOnly()	nesne ve IsReadOnly()ConfigurationElementCollection tüm alt öğeler için özelliğini ayarlar. (Devralındığı yer: ConfigurationElementCollection)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Yapılandırma bilgilerini yapılandırma hiyerarşisinin farklı düzeylerinden birleştirmenin etkisini tersine çevirir. (Devralındığı yer: ConfigurationElementCollection)

Belirtik Arabirim Kullanımları

ICollection.CopyTo(Array, Int32)

öğesini ConfigurationElementCollection bir diziye kopyalar. (Devralındığı yer: ConfigurationElementCollection)

Uzantı Metotları