KeyValueConfigurationCollection Kelas

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

KeyValueConfigurationCollection.cs

Berisi kumpulan KeyValueConfigurationElement objek.

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

Warisan

Object

ConfigurationElement

ConfigurationElementCollection

KeyValueConfigurationCollection

Atribut

ConfigurationCollectionAttribute

Contoh

Contoh kode berikut menunjukkan cara menggunakan jenis .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

Keterangan

Kelas ini mewakili kumpulan pasangan, di mana setiap pasangan terdiri dari string yang berfungsi sebagai kunci koleksi dan nilai string. Karena elemen pertama adalah kunci, elemen tersebut harus unik di seluruh koleksi.

Konstruktor

KeyValueConfigurationCollection()

Menginisialisasi instans baru kelas KeyValueConfigurationCollection.

Properti

AddElementName	Mendapatkan atau mengatur nama yang akan dikaitkan ConfigurationElement dengan operasi tambahkan di ConfigurationElementCollection saat ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
AllKeys	Mendapatkan kunci ke semua item yang terkandung KeyValueConfigurationCollection dalam koleksi.
ClearElementName	Mendapatkan atau menetapkan nama untuk ConfigurationElement mengaitkan dengan operasi yang jelas dalam ConfigurationElementCollection ketika ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
CollectionType	Mendapatkan jenis ConfigurationElementCollection. (Diperoleh dari ConfigurationElementCollection)
Count	Mendapatkan jumlah elemen dalam koleksi. (Diperoleh dari ConfigurationElementCollection)
CurrentConfiguration	Mendapatkan referensi ke instans tingkat Configuration atas yang mewakili hierarki konfigurasi tempat instans saat ini ConfigurationElement berada. (Diperoleh dari ConfigurationElement)
ElementInformation	ElementInformation Mendapatkan objek yang berisi informasi dan fungsionalitas ConfigurationElement objek yang tidak dapat disesuaikan. (Diperoleh dari ConfigurationElement)
ElementName	Mendapatkan nama yang digunakan untuk mengidentifikasi kumpulan elemen ini dalam file konfigurasi saat ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
ElementProperty	ConfigurationElementProperty Mendapatkan objek yang mewakili objek itu ConfigurationElement sendiri. (Diperoleh dari ConfigurationElement)
EmitClear	Mendapatkan atau menetapkan nilai yang menentukan apakah koleksi telah dibersihkan. (Diperoleh dari ConfigurationElementCollection)
EvaluationContext	ContextInformation Mendapatkan objek untuk ConfigurationElement objek . (Diperoleh dari ConfigurationElement)
HasContext	Mendapatkan nilai yang menunjukkan apakah CurrentConfiguration properti adalah null. (Diperoleh dari ConfigurationElement)
IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke koleksi disinkronkan. (Diperoleh dari ConfigurationElementCollection)
Item[ConfigurationProperty]	Mendapatkan atau mengatur properti atau atribut elemen konfigurasi ini. (Diperoleh dari ConfigurationElement)
Item[String]	KeyValueConfigurationElement Mendapatkan objek berdasarkan parameter yang disediakan.
LockAllAttributesExcept	Mendapatkan koleksi atribut terkunci. (Diperoleh dari ConfigurationElement)
LockAllElementsExcept	Mendapatkan koleksi elemen terkunci. (Diperoleh dari ConfigurationElement)
LockAttributes	Mendapatkan koleksi atribut terkunci. (Diperoleh dari ConfigurationElement)
LockElements	Mendapatkan koleksi elemen terkunci. (Diperoleh dari ConfigurationElement)
LockItem	Mendapatkan atau menetapkan nilai yang menunjukkan apakah elemen dikunci. (Diperoleh dari ConfigurationElement)
Properties	Mendapatkan kumpulan properti konfigurasi.
RemoveElementName	Mendapatkan atau mengatur nama ConfigurationElement untuk dikaitkan dengan operasi hapus di ConfigurationElementCollection saat ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
SyncRoot	Mendapatkan objek yang digunakan untuk menyinkronkan akses ke ConfigurationElementCollection. (Diperoleh dari ConfigurationElementCollection)
ThrowOnDuplicate	Mendapatkan nilai yang menunjukkan apakah upaya untuk menambahkan objek duplikat KeyValueConfigurationElement ke KeyValueConfigurationCollection koleksi akan menyebabkan pengecualian dilemparkan.

Metode

Add(KeyValueConfigurationElement)	KeyValueConfigurationElement Menambahkan objek ke koleksi berdasarkan parameter yang disediakan.
Add(String, String)	KeyValueConfigurationElement Menambahkan objek ke koleksi berdasarkan parameter yang disediakan.
BaseAdd(ConfigurationElement)	Menambahkan elemen konfigurasi ke ConfigurationElementCollection. (Diperoleh dari ConfigurationElementCollection)
BaseAdd(ConfigurationElement, Boolean)	Menambahkan elemen konfigurasi ke koleksi elemen konfigurasi. (Diperoleh dari ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Menambahkan elemen konfigurasi ke koleksi elemen konfigurasi. (Diperoleh dari ConfigurationElementCollection)
BaseClear()	Menghapus semua objek elemen konfigurasi dari koleksi. (Diperoleh dari ConfigurationElementCollection)
BaseGet(Int32)	Mendapatkan elemen konfigurasi di lokasi indeks yang ditentukan. (Diperoleh dari ConfigurationElementCollection)
BaseGet(Object)	Mengembalikan elemen konfigurasi dengan kunci yang ditentukan. (Diperoleh dari ConfigurationElementCollection)
BaseGetAllKeys()	Mengembalikan array kunci untuk semua elemen konfigurasi yang terkandung dalam ConfigurationElementCollection. (Diperoleh dari ConfigurationElementCollection)
BaseGetKey(Int32)	Mendapatkan kunci untuk di ConfigurationElement lokasi indeks yang ditentukan. (Diperoleh dari ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Menunjukkan indeks dari yang ditentukan ConfigurationElement. (Diperoleh dari ConfigurationElementCollection)
BaseIsRemoved(Object)	Menunjukkan apakah ConfigurationElement dengan kunci yang ditentukan telah dihapus dari ConfigurationElementCollection. (Diperoleh dari ConfigurationElementCollection)
BaseRemove(Object)	ConfigurationElement Menghapus dari koleksi. (Diperoleh dari ConfigurationElementCollection)
BaseRemoveAt(Int32)	Menghapus pada ConfigurationElement lokasi indeks yang ditentukan. (Diperoleh dari ConfigurationElementCollection)
Clear()	KeyValueConfigurationCollection Menghapus koleksi.
CopyTo(ConfigurationElement[], Int32)	Menyalin konten ConfigurationElementCollection ke array. (Diperoleh dari ConfigurationElementCollection)
CreateNewElement()	Ketika ditimpa di kelas turunan CreateNewElement() , metode membuat objek baru KeyValueConfigurationElement .
CreateNewElement(String)	Membuat baru ConfigurationElement saat ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Membaca XML dari file konfigurasi. (Diperoleh dari ConfigurationElement)
Equals(Object)	Membandingkan ConfigurationElementCollection dengan objek yang ditentukan. (Diperoleh dari ConfigurationElementCollection)
GetElementKey(ConfigurationElement)	Mendapatkan kunci elemen untuk elemen konfigurasi tertentu saat ditimpa di kelas turunan.
GetEnumerator()	Mendapatkan yang IEnumerator digunakan untuk melakukan iterasi melalui ConfigurationElementCollection. (Diperoleh dari ConfigurationElementCollection)
GetHashCode()	Mendapatkan nilai unik yang mewakili ConfigurationElementCollection instans. (Diperoleh dari ConfigurationElementCollection)
GetTransformedAssemblyString(String)	Mengembalikan versi yang diubah dari nama rakitan yang ditentukan. (Diperoleh dari ConfigurationElement)
GetTransformedTypeString(String)	Mengembalikan versi yang ditransformasi dari nama jenis yang ditentukan. (Diperoleh dari ConfigurationElement)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
Init()	Menyetel objek ke ConfigurationElement status awalnya. (Diperoleh dari ConfigurationElement)
InitializeDefault()	Digunakan untuk menginisialisasi sekumpulan nilai default untuk ConfigurationElement objek. (Diperoleh dari ConfigurationElement)
IsElementName(String)	Menunjukkan apakah yang ditentukan ConfigurationElement ada di ConfigurationElementCollection. (Diperoleh dari ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Menunjukkan apakah yang ditentukan ConfigurationElement dapat dihapus dari ConfigurationElementCollection. (Diperoleh dari ConfigurationElementCollection)
IsModified()	Menunjukkan apakah ini ConfigurationElementCollection telah dimodifikasi sejak terakhir disimpan atau dimuat saat ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
IsReadOnly()	Menunjukkan apakah ConfigurationElementCollection objek hanya dibaca. (Diperoleh dari ConfigurationElementCollection)
ListErrors(IList)	Menambahkan kesalahan properti yang tidak valid dalam objek ini ConfigurationElement , dan di semua sublemen, ke daftar yang diteruskan. (Diperoleh dari ConfigurationElement)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnDeserializeUnrecognizedAttribute(String, String)	Mendapatkan nilai yang menunjukkan apakah atribut yang tidak diketahui ditemui selama deserialisasi. (Diperoleh dari ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Menyebabkan sistem konfigurasi melemparkan pengecualian. (Diperoleh dari ConfigurationElementCollection)
OnRequiredPropertyNotFound(String)	Melemparkan pengecualian ketika properti yang diperlukan tidak ditemukan. (Diperoleh dari ConfigurationElement)
PostDeserialize()	Dipanggil setelah deserialisasi. (Diperoleh dari ConfigurationElement)
PreSerialize(XmlWriter)	Dipanggil sebelum serialisasi. (Diperoleh dari ConfigurationElement)
Remove(String)	KeyValueConfigurationElement Menghapus objek dari koleksi.
Reset(ConfigurationElement)	Mengatur ulang ConfigurationElementCollection ke status tidak dimodifikasi saat ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
ResetModified()	Mereset nilai properti ke IsModified()false ketika ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Menulis data konfigurasi ke elemen XML dalam file konfigurasi saat ditimpa di kelas turunan. (Diperoleh dari ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Menulis tag luar elemen konfigurasi ini ke file konfigurasi saat diimplementasikan di kelas turunan. (Diperoleh dari ConfigurationElement)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Mengatur properti ke nilai yang ditentukan. (Diperoleh dari ConfigurationElement)
SetReadOnly()	IsReadOnly() Mengatur properti untuk ConfigurationElementCollection objek dan untuk semua sub-elemen. (Diperoleh dari ConfigurationElementCollection)
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Membalikkan efek penggabungan informasi konfigurasi dari berbagai tingkat hierarki konfigurasi. (Diperoleh dari ConfigurationElementCollection)

Implementasi Antarmuka Eksplisit

ICollection.CopyTo(Array, Int32)

Menyalin ke ConfigurationElementCollection array. (Diperoleh dari ConfigurationElementCollection)

Metode Ekstensi