NameValueConfigurationCollection Kelas

Definisi

Ruang nama:

System.Configuration

Rakitan:

System.Configuration.ConfigurationManager.dll

Paket:

System.Configuration.ConfigurationManager v8.0.0

Sumber:

NameValueConfigurationCollection.cs

Berisi kumpulan NameValueConfigurationElement objek. Kelas ini tidak dapat diwariskan.

public ref class NameValueConfigurationCollection sealed : System::Configuration::ConfigurationElementCollection

[System.Configuration.ConfigurationCollection(typeof(System.Configuration.NameValueConfigurationElement))]
public sealed class NameValueConfigurationCollection : System.Configuration.ConfigurationElementCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Configuration.NameValueConfigurationElement))>]
type NameValueConfigurationCollection = class
    inherit ConfigurationElementCollection

Public NotInheritable Class NameValueConfigurationCollection
Inherits ConfigurationElementCollection

Warisan

Object

ConfigurationElement

ConfigurationElementCollection

NameValueConfigurationCollection

Atribut

ConfigurationCollectionAttribute

Contoh

Contoh kode berikut menunjukkan cara menggunakan jenis .NameValueConfigurationCollection

#region Using directives

using System;
using System.Configuration;
using System.Web.Configuration;
using System.Collections;
using System.Text;

#endregion

namespace Samples.AspNet
{
    class UsingNameValueConfigurationCollection
    {
        static void Main(string[] args)
        {
            try
            {
                // Set the path of the config file.
                // Make sure that you have a Web site on the
                // same server called TestConfig.
                string configPath = "/TestConfig";

                // Get the Web application configuration object.
                Configuration config =
                  WebConfigurationManager.OpenWebConfiguration(configPath);

                // Get the section related object.
                AnonymousIdentificationSection configSection =
                  (AnonymousIdentificationSection)config.GetSection
                  ("system.web/anonymousIdentification");

                // Display title and info.
                Console.WriteLine("Configuration Info");
                Console.WriteLine();

                // Display Config details.
                Console.WriteLine("File Path: {0}",
                  config.FilePath);
                Console.WriteLine("Section Path: {0}",
                  configSection.SectionInformation.Name);
                Console.WriteLine();

                // Create a NameValueConfigurationCollection object.
                NameValueConfigurationCollection myNameValConfigCollection =
                  new NameValueConfigurationCollection();

                foreach (PropertyInformation propertyItem in
                  configSection.ElementInformation.Properties)
                {
                    // Assign  domain name.
                    if (propertyItem.Name == "domain")
                        propertyItem.Value = "MyDomain";

                    if (propertyItem.Value != null)
                    {
                        // Enable SSL for cookie exchange.
                        if (propertyItem.Name == "cookieRequireSSL")
                            propertyItem.Value = true;

                        NameValueConfigurationElement nameValConfigElement =
                            new NameValueConfigurationElement
                                (propertyItem.Name.ToString(), propertyItem.Value.ToString());

                        // Add a NameValueConfigurationElement
                        // to the collection.
                        myNameValConfigCollection.Add(nameValConfigElement);
                    }
                }

                // Count property.
                Console.WriteLine("Collection Count: {0}",
                 myNameValConfigCollection.Count);

                // Item property.
                Console.WriteLine("Value of property 'enabled': {0}",
                 myNameValConfigCollection["enabled"].Value);

                // Display the contents of the collection.
                foreach (NameValueConfigurationElement configItem
                  in myNameValConfigCollection)
                {
                    Console.WriteLine();
                    Console.WriteLine("Configuration Details:");
                    Console.WriteLine("Name: {0}", configItem.Name);
                    Console.WriteLine("Value: {0}", configItem.Value);
                }

                // Assign the domain calue.
                configSection.Domain = myNameValConfigCollection["domain"].Value;
                // Assign the SSL required value.
                if (myNameValConfigCollection["cookieRequireSSL"].Value == "true")
                    configSection.CookieRequireSSL = true;

                // Remove domain from the collection.
                NameValueConfigurationElement myConfigElement =
                    myNameValConfigCollection["domain"];
                // Remove method.
                myNameValConfigCollection.Remove(myConfigElement);

                // Save changes to the configuration file.
                // This modifies the Web.config of the TestConfig site.
                config.Save(ConfigurationSaveMode.Minimal, true);

                // Clear the collection.
                myNameValConfigCollection.Clear();
            }

            catch (Exception e)
            {
                // Unknown error.
                Console.WriteLine(e.ToString());
            }

            // Display and wait.
            Console.ReadLine();
        }
    }
}

Imports System.Configuration
Imports System.Web
Imports System.Collections
Imports System.Text


Namespace Samples.AspNet
    Class UsingNameValueConfigurationCollection
        Public Shared Sub Main(ByVal args As String())
            Try
                ' Set the path of the config file. 
                ' Make sure that you have a Web site on the
                ' same server called TestConfig.
                Dim configPath As String = "/TestConfig"

                ' Get the Web application configuration object.
                Dim config As Configuration = _
                System.Web.Configuration.WebConfigurationManager.OpenWebConfiguration(configPath)

                ' Get the section related object.
                Dim configSection _
                As System.Web.Configuration.AnonymousIdentificationSection = _
                DirectCast(config.GetSection("system.web/anonymousIdentification"),  _
                System.Web.Configuration.AnonymousIdentificationSection)

                ' Display title and info.
                Console.WriteLine("Configuration Info")
                Console.WriteLine()

                ' Display Config details.
                Console.WriteLine("File Path: {0}", config.FilePath)
                Console.WriteLine("Section Path: {0}", configSection.SectionInformation.Name)
                Console.WriteLine()

                ' Create a NameValueConfigurationCollection object.
                Dim myNameValConfigCollection As New NameValueConfigurationCollection()

                For Each propertyItem As PropertyInformation In configSection.ElementInformation.Properties
                    ' Assign  domain name.
                    If propertyItem.Name = "domain" Then
                        propertyItem.Value = "MyDomain"
                    End If

                    If propertyItem.Value <> Nothing Then
                        ' Enable SSL for cookie exchange.
                        If propertyItem.Name = "cookieRequireSSL" Then
                            propertyItem.Value = True
                        End If

                        Dim nameValConfigElement As New NameValueConfigurationElement(propertyItem.Name.ToString(), propertyItem.Value.ToString())

                        ' Add a NameValueConfigurationElement
                        ' to the collection.

                        myNameValConfigCollection.Add(nameValConfigElement)
                    End If
                Next

                ' Count property.
                Console.WriteLine("Collection Count: {0}", myNameValConfigCollection.Count)

                ' Item property.
                Console.WriteLine("Value of property 'enabled': {0}", myNameValConfigCollection("enabled").Value)

                ' Display the contents of the collection.
                For Each configItem As NameValueConfigurationElement In myNameValConfigCollection
                    Console.WriteLine()
                    Console.WriteLine("Configuration Details:")
                    Console.WriteLine("Name: {0}", configItem.Name)
                    Console.WriteLine("Value: {0}", configItem.Value)
                Next

                ' Assign the domain calue.
                configSection.Domain = myNameValConfigCollection("domain").Value
                ' Assign the SSL required value.
                If myNameValConfigCollection("cookieRequireSSL").Value = "true" Then
                    configSection.CookieRequireSSL = True
                End If

                ' Remove domain from the collection.
                Dim myConfigElement As NameValueConfigurationElement = myNameValConfigCollection("domain")
                ' Remove method.
                myNameValConfigCollection.Remove(myConfigElement)

                ' Save changes to the configuration file.
                ' This modifies the Web.config of the TestConfig site.
                config.Save(ConfigurationSaveMode.Minimal, True)

                ' Clear the collection.
                myNameValConfigCollection.Clear()
            Catch e As Exception

                ' Unknown error.
                Console.WriteLine(e.ToString())
            End Try

            ' Display and wait.
            Console.ReadLine()
        End Sub
    End Class
End Namespace

Keterangan

Kelas ini NameValueConfigurationCollection memungkinkan Anda untuk mengakses koleksi NameValueConfigurationElement objek secara terprogram.

Konstruktor

NameValueConfigurationCollection()

Menginisialisasi instans baru kelas NameValueConfigurationCollection.

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 untuk semua item yang terkandung dalam NameValueConfigurationCollection.
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]	Mendapatkan atau mengatur NameValueConfigurationElement 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 koleksi properti. (Diperoleh dari ConfigurationElement)
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 duplikat ConfigurationElement ke ConfigurationElementCollection akan menyebabkan pengecualian dilemparkan. (Diperoleh dari ConfigurationElementCollection)

Metode

Add(NameValueConfigurationElement)	NameValueConfigurationElement Menambahkan objek ke koleksi.
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()	NameValueConfigurationCollectionMenghapus .
CopyTo(ConfigurationElement[], Int32)	Menyalin konten ConfigurationElementCollection ke array. (Diperoleh dari ConfigurationElementCollection)
CreateNewElement()	Ketika ditimpa di kelas turunan, membuat baru ConfigurationElement. (Diperoleh dari ConfigurationElementCollection)
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. (Diperoleh dari ConfigurationElementCollection)
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(NameValueConfigurationElement)	NameValueConfigurationElement Menghapus objek dari koleksi berdasarkan parameter yang disediakan.
Remove(String)	NameValueConfigurationElement Menghapus objek dari koleksi berdasarkan parameter yang disediakan.
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

Lihat juga

• NameValueConfigurationElement